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1. 


Introduction 


The TMS320C25 Digital Signal Processor is a member of the TMS320 family of VLSI 
digital signal processors and peripherals. The TMS320 family supports realtime 
digital signal processing (DSP) and computation-intensive applications in the areas 
of telecommunications, modems, speech processing, graphics/image processing, 
spectrum analysis, audio processing, digital filtering, high-speed control, instru- 
mentation, and numeric processing. 


The architectural investment made in the TMS320 family provides the user with a 
choice of five distinct processors (TMS32010, TMS320C10, TMS32011, 
TMS32020, TMS320C25) to best support a wide spectrum of DSP applications. 
Software compatibility is maintained throughout the family to protect the user’s 
investment in the architecture. Each processor has software and hardware tools to 
facilitate rapid design. 


The first processor in the TMS320 family is the TMS32010, a microcomputer with 
a 32-bit internal Harvard architecture and a 16-bit external interface capable of 
executing five million instructions per second. The TMS32020 is the next processor 
in the family with an architecture based on that of the TMS32010. Major architectural 
changes made on the TMS32020 enable the device to lower system cost and improve 
throughput by two to three times over the TMS32010 for DSP applications. The 
TMS32020 instruction set is a superset of that of the TMS32010, thus maintaining 
software compatibility. 


The TMS320C25 is a pin-compatible CMOS version of the TMS32020 with a faster 
instruction cycle time and the inclusion of additional hardware and software features. 
The TMS320C25 is completely object code-compatible with the TMS32020 so that 
TMS32020 programs run unmodified on the TMS320C25. Some of the major 
enhancements of the TMS320C25 over the TMS32020 are as follows: 


Faster instruction cycle time: 100 ns 

Low-power CMOS technology with powerdown mode 

4K words of on-chip masked ROM 

Eight auxiliary registers with a dedicated arithmetic unit 
Eight-level hardware stack 

Fully static double-buffered serial port 

Concurrent DMA using an extended hold operation 
Bit-reversed addressing modes for radix-2 FFTs 
Extended-precision arithmetic and adaptive filtering support 
Full-speed operation of MAC/MACD from external memory 
Accumulator carry bit and related instructions 


Development tools and applications support are key advantages to using the 
TMS320C25. Full-speed emulators, software simulators and assemblers, and exten- 
sive documentation including over 735 pages of application reports provide for rapid 
design and development cycles. Texas Instruments regional technology centers, 
system application engineers, and third-party support are available for DSP educa- 
tion, training, and design. 
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/ 1.1 General Description 
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The TMS320C25 architecture is based upon that of the TMS32020 digital signal 
processor. The TMS320C25 increases performance of DSP algorithms through a 
faster instruction cycle time and innovative additions to the TMS320 family archi- 
tecture. The TMS320C25 is object code-compatible with the TMS32020, thus 
enabling current TMS32020 programs to run unmodified on the TMS320C25. 

f 


Two versions of the TMS320C25 are available to support price and performance 
requirements for different applications: 100-ns and 125-ns instruction cycle time 
versions. | 


The 100-ns instruction cycle time provides double the throughput for existing 
applications. Since most instructions are capable of executing in a single cycle, the 
processor is capable of executing ten million instructions per second (10 MIPS). 
Increased throughput on the TMS320C25 for many DSP applications is attained by 
means of single-cycle multiply/accumulate instructions with a data move option, 
eight auxiliary registers with a dedicated arithmetic unit, instruction set support for 
adaptive filtering and extended-precision arithmetic, bit-reversal addressing, and 
faster |/O necessary for data-intensive signal processing. | 


The architectural design of the TMS320C25 emphasizes overall system speed, 
communication, and flexibility in processor configuration. Control signals and 
instructions provide block memory transfers, communication to slower off-chip 
devices, multiprocessing implementations, and floating-point support. 


Two large on-chip data RAM blocks (a total of 544 words), one of which is 
configurable either as program or data memory, provide increased flexibility in system 
design. An off-chip 64K-word directly addressable data memory address space is 
included to facilitate implementations of DSP algorithms. The large on-chip 4K-word 
masked ROM can be used to cost-reduce systems, thus providing for a true 
single-chip DSP solution. Programs of up to 4K words can be masked into the 
internal program ROM. The remainder of the 64K-word program memory space is 
located externally. Large programs can execute at full speed from this memory space. 
Programs may also be downloaded from slow external memory to on-chip RAM for 
full-speed operation. The VLSI implementation of the TMS320C25 incorporates all 
of these features as well as many others such as a hardware timer, serial port, and 
block data transfer capabilities. 
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1.2 Typical Applications 


The TMS320 family’s unique versatility and power offer a new approach to a variety 
- of sophisticated applications. Table 1-1 lists some typical applications of the 
TMS320 family. 


Table 1-1. Typical Applications of the TMS320 Family 


‘GENERAL-PURPOSE DSP___ GRAPHICSAMAGING INSTRUMENTATION 


3-D Rotation © 
Robot Vision 
Image Transmission/ 






Digital Filtering Spectrum Analysis 















Convolution Function Generation 















Correlation Pattern Matching 


Hilbert Transforms Compression Seismic Processing 


Fast Fourier Transforms Pattern Recognition 


Transient Analysis 





Adaptive Filtering Image Enhancement Digital Filtering 






Windowing Homomorphic Processing Phase-Locked Loops 
Workstations 


Animation/Digital Map 


Waveform Generation 





VOICE/SPEECH } CONTROL MILITARY 


Voice Mail - ~ Disk Control | Secure Communications 
Speech Vocoding ‘Servo Control Radar Processing 
Speech Recognition Robot Control — Sonar Processing 
Speaker Verification Laser Printer Control Image Processing 


Speech Enhancement > Engine Control Navigation 
Speech Synthesis Motor Control Missile Guidance 
Text to Speech | Radio Frequency Modems 


7 TELECOMMUNICATIONS AUTOMOTIVE 


Echo Cancellation FAX Engine Control 
ADPCM Transcoders Cellular Telephones Vibration Analysis 
Digital PBXs | Speaker Phones Antiskid Brakes 

Line Repeaters Digital Speech Adaptive Ride Control 
Channel Multiplexing Interpolation (DS!) Global Positioning 
1200 to 19200-bps Modems X.25 Packet Switching Navigation 

Adaptive Equalizers Video Conferencing Voice Commands 
DTMF Encoding/Decoding Spread Spectrum Digital Radio 

Data Encryption Communications Cellular Telephones 


CONSUMER INDUSTRIAL MEDICAL 


Radar Detectors Robotics Hearing Aids 
Power Tools Numeric Control Patient Monitoring 
Digital Audio/TV Security Access Ultrasound Equipment 








Music Synthesizer Power Line Monitors Diagnostic Tools 
Educational Toys Prosthetics 
Fetal Monitors 
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Many of the TMS320C25’s features, such as single-cycle multiply/accumulate 
instructions, 32-bit arithmetic unit, large auxiliary register file with a separate arith- 
metic unit, and large on-chip RAM and ROM, make the device particularly applicable 
in digital signal processing systems. At the same time, general-purpose applications 
of the TMS320C25 are greatly enhanced by its large address spaces, on-chip timer, 
serial port, multiple interrupt structure, provision for external wait states, and multi- 
processor interface capability. 


The flexibility of the TMS320C25 allows it to be configured to satisfy a wide range 
of system requirements. This allows the device to be applied in systems currently 
using costly bit-slice processors or custom ICs. Some of the system configurations 
are: 


@ A standalone system using 4K words of on-chip ROM and 544 words of 
on-chip RAM 

@ Parallel multiprocessing systems with shared global data memory 

®@ Host/peripheral coprocessing using interface control signals. 


1.3 Key Features 


The TMS320C25 Digital Signal Processor offers a cost-effective alternative to custom 
VLSI and bit-slice devices. It has the following significant key features: 


100-ns instruction cycle time 
544 words of on-chip data RAM 
4K words of on-chip masked ROM 
128K words of data/program space 
Single-cycle multiply/accumulate instructions 
Object code-compatible with the TMS32020 
16-bit instruction and data words 
32-bit ALU and accumulator 
16-bit parallel shifter 
Block moves for efficient data/program management 
Unsigned multiply instruction for extended-precision arithmetic 
Carry bit with associated add and subtract instructions 
Instructions for floating-point operations and adaptive filtering 
Eight auxiliary registers and a dedicated arithmetic unit 
Bit-reversed indexed addressing mode for radix-2 FFTs 
Wait states for communication to slow off-chip memories/peripherals 
Double-buffered static serial port for direct codec interface 
Three external, maskable user interrupts 
Synchronization capability between multiple processors 
On-chip clock generator 
1.8-micron CMOS technology; single 5-volt supply 
68-pin plastic leaded chip carrier (PLCC) 
Two versions available: 

40-MHz clock 

32-MHz clock 
@ Commercial and military versions supported. 
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1.4 How To Use This Manual | 
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The purpose of this user’s guide is to serve as a reference book for the TMS320C25 
Digital Signal Processor. Sections 2 through 6 provide specific information about the 


_architecture and operation of the device, and Sections 7 through 9 describe how to 


use the macro assembler/linker support software. TMS320C25 electrical specifica- 
tions and mechanical data can be found in the data sheet (Appendix A). 


This user’s guide is designed to provide information that assists managers and 


_hardware/software engineers in application development. The Introduction and 


Architectural Overview sections provide managers with basic information § that 
describes the capabilities of the TMS320C25 for a particular application. The hard- 
ware engineer will find the Architectural Overview, Device Operation, and Hardware 
Applications sections and the Data Sheet and System Migration appendices most 
helpful. The Assembly Language Instructions, Software Applications, Assembler 
Directives, Macros, and Link Editor sections and the Instruction Cycle Timings, 
Development Support, and Software Installation appendices will aid the software 
engineer. 


The following table lists each section and briefly describes the section contents. 


Section 2. Architectural Overview. Brief description of the TMS320C25 
hardware components and their functions. Block diagram, pinout 
of the 68-pin plastic leaded chip carrier (PLCC) package, a table 
of signal descriptions, and a list of TMS320C25 instructions. 


Section 3. Device Operation. -TMS320C25 design description, hardware 
components, and their functions. Functional block diagram and 
internal hardware summary table. 


Section 4. Assembly Language Instructions. Addressing modes and format 
descriptions. Instruction set summary listed according to function. 
Alphabetized individual instruction descriptions with examples. 


Section 5. Software Applications. Software application examples for the use 
of various TMS320C25 instruction set features. 


Section 6. Hardware Applications. Hardware design techniques and applica- 
tion examples for interfacing to codecs or external memory. 


Section 7. Assembler Directives. Description of assembly language source 
statement, source listing, and object code format. Individual 
assembler directive descriptions in alphabetical order. Assembler 
error diagnostics. 


Section 8. Assembler Macros. Description of macro assembly language 
elements. Individual macro verb descriptions. Several macro 
examples given. Macro error diagnostics. 


Section 9. Link Editor. Description of link editor and its files. Individual linker 
command descriptions in alphabetical order. Examples of simple 
linking, ROM/RAM partitioning, partial linking, and library creation 
given. Linker error diagnostics. 





Seven appendices are included to provide additional information. 


Appendix A. TMS320C25 Data Sheet. Electrical specifications, timing, and 
mechanical data for the TMS320C25. 








Appendix B. TMS32020 Data Sheet. Electrical specifications, timing, and 
mechanical data for the TMS32020 Digital Signal Processor. 
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Appendix C. TMS320C10 Data Sheet. Electrical specifications, timing, and 





mechanical data for the TMS320C10 Digital Signal Processor. 


Appendix D. TMS32020/TMS320C25 System Migration. Information for 


upgrading a TMS32020-based system to a TMS320C25-based 
system. 


Appendix E. TMS320C25 Instruction Cycle Timings. Listing of the number of 


cycles for an instruction to execute in a given memory configura- 
tion. 


Appendix F. TMS320C25 Development Support/Part Order Information. List- 


ings of the hardware and software available to support the 
TMS320C25. 


Appendix G. JTMS320C25 Macro Assembler and Link Editor Installation. Series 


1.5 References 


of procedures used to install and verify the TMS320C25 Macro 
Assembler and Link Editor on a VAX or TI/IBM PC. 


The following reference list contains useful information regarding functions, oper- 
ations, and applications of digital signal processing. These books also list other 
references to many useful technical papers. The references are organized into cate- 
gories of general DSP, speech, image processing, and digital control theory. 


General Digital Signal Processing: 


Antoniou, Andreas, Digital Filters: Analysis and Design. New York, NY: 
McGraw-Hill Company, Inc., 1979. 


Brigham, E. Oran, The Fast Fourier Transform. Englewood Cliffs, NJ: Pren- 
tice-Hall, Inc., 1974. 


Burrus, C.S. and Parks, T.W., DF7/FFT and Convolution Algorithms. New York, 
NY: John Wiley & Sons, Inc., 1984. 


Digital Signal Processing Applications with the TMS320 Family, Texas Instru- 
ments, 1986. 


Gold, Bernard and Rabiner, Lawrence R., Theory and Application of Digital 
Signal Processing. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1975. 


Gold, Bernard and Rader, C.M., Digital Processing of Signals. New York, NY: 
McGraw-Hill Company, Inc., 1969. 


Hamming, R.W., Digital Filters. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1977. 


IEEE ASSP DSP Committee (Editor), Programs for Digital Signal Processing. 
New York, NY: IEEE Press, 1979. 


Jackson, Leland B., Digital Filters and Signal Processing. Hingham, MA: Kluwer 
Academic Publishers, 1986. 


Morris, L. Robert, Digital Signal Processing Software. Ottawa, Canada: Carleton 
University, 1983. 


Oppenheim, Alan V. (Editor), Applications of Digital Signal Processing. 


Englewood Cliffs, NJ: Prentice-Hall, Inc., 1978. 
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‘Oppenheim, Alan V. and Schafer, R.W., Digital Signal Processing. Englewood 
Cliffs, NJ: Prentice-Hall, Inc., 1975. | 


Oppenheim, Alan V. and Willsky, A.N. with Young, L.T., Signals and Systems. 
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1983. 


Parks, T.W. and Burrus, C.S., Digital Filter Design. NEW York, NY: John Wiley 
& Sons, Inc., 1986. 


Speech: 


Gray, A.H. and Markel, J.D., Linear Production of Speech. New York, NY: 
Springer-Verlag, 1976. 


Jayant, N.S. and Noll, Peter, Digital Coding of Waveforms. Englewood Cliffs, 


NJ: Prentice-Hall, Inc., 1984. 


Papamichalis, Panos, Practical Approaches to Speech Coding. Englewood 
Cliffs, NJ: Prentice-Hall, Inc., 1986. 


Rabiner, Lawrence R. and Schafer, R.W., Digital Processing of Speech 
Signals. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1978. 


Image Processing: 


Andrews, H.C. and Hunt, B.R., Digital Image Restoration. Englewood Cliffs, 
NJ: Prentice-Hall, Inc., 1977. 


Gonzales, Rafael C. and Wintz, Paul, Digita/ Image Processing. Reading, MA: 
Addison-Wesley Publishing Company, Inc., 1977. 


Pratt, William K., Digital /mage Processing. New York, NY: John Wiley & Sons, 
1978. 


Digital Control Theory: 
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Jacquot, R., Modern Digital Control Systems. New York, NY: Marcel Dekker, 
Inc., 1981. 


Katz, P., Digital Control Using Microprocessors. Englewood Cliffs, NJ: Pren- 
tice- Hall, Inc., 1981. 


Kuo, B.C., Digital Control Systems. New York, NY: Holt, Reinholt and Winston, 
Inc., 1980. 


Moroney, P., /ssues in the Implementation of Digital Feedback Compensators. 
Cambridge, MA: The MIT Press, 1983. 


Phillips, C. and Nagle, H., Digital Control System Analysis and Design. 
Englewood Cliffs, NJ: Prentice-Hall, Inc., 1984. 


2. Architectural Overview 


The TMS320C25 high-performance digital signal processor implements a single- 
accumulator, Harvard-type architecture in which program and data memory reside 
in separate address spaces. This allows a full overlap of instruction fetch and 
execution. Instructions are included to provide data transfers between the two 
spaces. Externally, the program and data memory spaces are multiplexed over the 
Same bus so as to maximize the address range for both spaces while minimizing the 
pin count of the device. Internally, the TMS320C25 architecture maximizes proc- 
essing power by maintaining two separate bus structures, program and data, for 
full-speed execution. Increased flexibility in system design is provided by two large 
on-chip data RAM blocks, one of which is configurable either as program or data 
memory. 


The TMS320C25 incorporates a separate level of pipelining for instruction decoding. 
The instruction fetch-decode-execute pipeline is essentially invisible to the user, 
except in some cases where the pipeline must be broken (such as for branch 
instructions). In this case, the instructions will have slightly different timing charac- 
teristics than the TMS32020. Other instructions, such as those that operate with 
external data memory, have improved cycle timings compared to the TMS32020. The 
device executes the majority of its instructions in a single machine cycle when 
sufficiently fast memory is utilized. The device may also communicate to slower 
off-chip memories or peripherals by utilizing the READY signal. In those cases, the 
instructions become multicycle. 


The major topics discussed in this section are as follows: 


® Functional Block Diagram (Section 2.1 on page 2-3) 

e Pinout and Signal Descriptions (Section 2.2 on page 2-3) 

® Memory (Section 2.3 on page 2-7) 

@ Central Arithmetic Logic Unit (CALU) (Section 2.4 on page 2-10) 
@ System Control (Section 2.5 on page 2-11) 

e |/O Interface (Section 2.6 on page 2-12) 

@ System Configurations (Section 2.7 on page 2-12) 

@ Addressing Modes and Instructions (Section 2.8 on page 2-15) 


@ Development Support (Section 2.9 on page 2-22) 
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Serial port data transmit register TR = Temporary register 


Figure 2-1. TMS320C25 Block Diagram 
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Architectural Overview 


2.1 Functional Block Diagram 


The functional block diagram of the TMS320C25, shown in Figure 2-1, outlines the 
principal blocks and data paths within the processor. The diagram also shows all of 
the TMS320C25 interface pins. 


The TMS320C25 architecture is built around two major buses: the program bus and 
the data bus. The program bus carries the instruction code and immediate operands 
from program memory. The data bus interconnects various elements, such as the 
Central Arithmetic Logic Unit (CALU) and the auxiliary register file, to the data RAM. 
Together, the program and data buses can carry data from on-chip data RAM and 
internal or external program memory to the multiplier in a single cycle for 
multiply/accumulate operations. 


The TMS320C25 has a high degree of parallelism; e.g., while the data is being 
Operated upon by the CALU, arithmetic operations may also be implemented in the 
Auxiliary Register Arithmetic Unit (ARAU). Such parallelism results in a powerful 
set of arithmetic, logic, and bit-manipulation operations that may all be performed 
in a single machine cycle. 


2.2 Pinout and Signal Descriptions 


The TMS320C25 is packaged in a 68-pin plastic leaded chip carrier (PLCC). The 
electrical specifications and mechanical data are given in Appendix A, the 
TMS320C25 Data Sheet. Figure 2-2 shows a pinout of the TMS320C25 PLCC 
package. Table 2-1 lists each TMS320C25 signal, its pin location, function, and 
input, output, or high-impedance state (1/O/Z). The signals in Table 2-1 are grouped 
according to function and alphabetized within that grouping. 


Adaptor sockets are commercially available to convert a TMS320C25 PLCC package 
to a TMS32020-like 68-pin grid array (PGA) footprint, thus maintaining plug-in 
compatibility. 
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Figure 2-2. TMS320C25 Pin Assignments 
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Table 2-1. TMS320C25 Signal Descriptions 


| SIGNAL | PIN |1/o/Zt DESCRIPTION 
ADDRESS/DATA BUSES 


A15 MSB | ‘Parallel address bus A15 (MSB) through AO (LSB). Multiplexed to address external 
A14 data/program memory or |/O. Placed in high-impedance state in the hold mode. 
. A13 





D115 MSB 1/0/Z } Parallel data bus D15 (MSB) through DO (LSB). Multiplexed to transfer data between 
D14 the TMS320C25 and external data/program memory or |/O devices. Placed in high- 
D13 impedance state when not outputting or when RS or HOLD is asserted. 

D12 








INTERFACE CONTROL SIGNALS 


Bs 45 0/Z Data, program, and I/O space select signals. Always high unless low level asserted for 
PS 47 communicating to a particular external space. Placed in high-impedance state in the 


















Read/write signal. Indicates transfer direction when communicating to an external device. 












IS 46 hold mode. 
Data ready input. Indicates that an external device is prepared for the bus transaction to 
be completed. If the device is not ready (READY = 0), the TMS320C25 waits one cycle 
and checks READY again. READY also indicates a bus grant to an external device after 
a BR (bus request) signal. 
R/W 0/Z 
Normally in read mode (high), unless low level asserted for performing a write operation. 
Placed in high-impedance state in the hold mode. 
STRB 0/Z Strobe signal. Always high unless asserted low to indicate an external bus cycle. Placed 
in high-impedance state in the hold mode. 
_ MULTIPROCESSING SIGNALS 
Bus request signal. Asserted when the TMS320C25 requires access to an external global 
data memory space. READY is asserted to the device when the bus is available and the 
global data memory is available for the bus transaction. 
67 Hold input. When asserted, the TMS320C25 places the data, address, and control lines 
in the high-impedance state. 
HOLDA Hold acknowledge signal. Indicates that the TMS320C25 has gone into the hold mode 
and that an external processor may access the local external memory of the TMS320C25. 
SYNC Synchronization input. Allows clock synchronization of two or more TMS320C25s. SYNC 
| is an active-low signal and must be asserted on the rising edge of CLKIN. 
T Input/Output/High-impedance state | 
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Table 2-1. TMS320C25 Signal Descriptions (Concluded) 
| SIGNAL | PIN |Wo/zt}] DESCRIPTION, 


INTERRUPT AND MISCELLANEOUS SIGNALS 
Branch control input. Polled by BIOZ instruction. If low, the TMS320C25 executes a 
branch. This signal must be active during the BIOZ instruction fetch. 
Interrupt acknowledge signal. Output is only valid while CLKOUT1 is low. Indicates 


receipt of an interrupt and that the program is branching to the interrupt-vector location 
indicated by A15-A0. 


INT2 22 External user interrupt inputs. Prioritized and maskable by the interrupt mask register 
INT1 rH and the interrupt mode bit. 
INTO 
MP/MC Microprocessor/microcomputer mode select pin. When asserted low, the pin causes the 
internal ROM to be mapped into the lower 4K words of the program memory map. 


Microstate complete signal. Asserted low and valid only during CLKOUT1 low when the 
TMS320C25 has just Ue ee a memory operation, such as an instruction fetch or a 
data memory read/write. can be used to generate a one wait-state READY signal 
for slow memory. 








a 








I Reset input. Causes the TMS320C25 to terminate execution and forces the program 
counter to zero. When brought to a high level, execution begins at location zero of 
program memory. RS affects various registers and status bits. 


XF External flag output (latched software-programmable signal). Used for signalling other 
processors in multiprocessor configurations or as a general-purpose output pin. 








SUPPLY/OSCILLATOR SIGNALS 
CLKOUT1 Master clock output signal (CLKIN frequency/4). Rises at the beginning of quarter-phase 
3 (O3) and falls at the beginning of quarter-phase 1 (Q1). 
CLKOUT2 A second clock output signal. Rises at the beginning of quarter-phase 2 (Q2) and fails 
at beginning of quarter-phase 4 (Q4). 


Four 5-V supply pins, tied together externally. 





Output pin from the internal oscillator for the crystal. If a crystal is not used, this pin 
should be left unconnected. 

Input pin to the internal oscillator from the crystal. If a crystal is not used, a clock may 
be input to the device on this pin. 


SERIAL PORT SIGNALS 


Receive clock input. External clock signal for clocking data from the DR (data receive) 
pin into the RSR (serial port receive shift register). Must be present during serial port 
transfers. 


iT Three ground pins, tied together externally. 





Transmit clock input. External clock signal for clocking data from the XSR (serial port 
transmit shift register) to the DX (data transmit) pin. Must be present during serial port 
transfers. 


Serial data receive input. Serial data is received in the RSR (serial port receive shift 
register) via the DR pin. 








Serial data transmit output. Serial data transmitted from the XSR (serial port transmit shift 
register) via the DX pin. Placed in high-impedance state when not transmitting. 


Frame synchronization pulse for receive input. The falling edge of the FSR pulse initiates 
the data-receive process by gating the clock for receive (CLKR) input to the DRR (serial 
port data receive register), and beginning the clocking of the RSR. 


- Frame synchronization pulse for transmit input/output. The falling edge of the FSX pulse 
initiates the data-transmit process by gating the clock for transmit (CLKX) input to the 











shift register associated with DXR (serial port data transmit register), and beginning the 
clocking of the XSR. The FSX is normally an input, but this pin is an output when the 
TXM in the status register is set to 1. 


T input Ourout/ High: impedance state 
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2.3 Memory 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM, which 
is divided into three separate blocks (BO, B1, and B2). Of the 544 words, 256 words 
(block BO) are configurable as either data or program memory by CNFD or CNFP 
instructions provided for that purpose; 288 words (blocks B1 and B2) are always 
data memory. A data memory size of 544 words allows the TMS320C25 to handle 
a data array of 512 words while still leaving 32 locations for intermediate storage. 
The TMS320C25 provides 64K words of off-chip directly addressable data memory 
space. 


The TMS320C25 is equipped with a 4096-word on-chip ROM that can be mask- 
programmed at the factory with a customer’s program. The ROM may be mapped 
in or out of the TMS320C25’s memory space by an external pin on the device, 
MicroProcessor/MicroComputer select (MP/MC). This permits the designer to 
accelerate time-to-market with a TMS320C25-based product by using external ROM, 
and cost-reducing it later with the large 4K internal ROM on the device without any 
PC-board redesign. The TMS320C25 provides 64K words of off-chip program 
memory space in which programs can be executed at full speed with sufficiently fast 
memory or with wait states inserted for slower memories. Block BO may also be used 
as program memory. Instructions can be downloaded from slow (inexpensive) 
external program memory by using block repeats from program to data memory 
(RPTK and BLKP). The block can then be configured as program memory using the 
CNEFP instruction. In this way, small time-critical blocks of program memory can 
be stored inexpensively yet executed at full speed. 


The TMS320C25 provides three separate address spaces for program memory, data 
memory, and |/O. In addition to blocks BO, B1, and B2, the data memory map (see 
Figure 2-3) includes the memory-mapped registers and reserved locations. Six 
peripheral registers including the serial port registers, timer register, period register, 
interrupt mask register, and global memory allocation register have been mapped into 
the data memory space for easy modification. Reserved locations may not be used 
for storage, and their contents are undefined when read. 
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Figure 2-3. TMS320C€25 Memory Maps 


Architectural Overview 


The TMS320C25 provides a register file containing eight Auxiliary Registers 
(ARO-AR7), which may be used for indirect addressing of data memory or for 
temporary storage. These registers may be either directly addressed by an instruction 
or indirectly addressed by a three-bit Auxiliary Register Pointer (ARP). The auxiliary 
registers and the ARP may be loaded from either data memory or by an immediate 
operand defined in the instruction. The contents of these registers may also be stored 
into data memory. 


The auxiliary register file is connected to the Auxiliary Register Arithmetic Unit 
(ARAU). The ARAU may autoindex the current auxiliary register while the data 
memory location is being addressed. Indexing by either +/-1 or the contents of ARO 
may be performed. As a result, accessing tables of information does not require the 
CALU for address manipulation, thus freeing it for other operations. 


Although the ARAU is useful for address manipulation in parallel with other oper- 
ations, it may also serve as an additional general-purpose arithmetic unit since the 
auxiliary register file can directly communicate with data memory. The ARAU 
implements 16-bit unsigned arithmetic, whereas the CALU implements 32-bit 
two’s-complement arithmetic. Branches dependent on the comparison of ARO with 
the auxiliary register pointed to by ARP are also provided. 


The TMS320C25 contains a 16-bit Program Counter (PC), a 16-bit Prefetch Counter 
(PFC), a MicroCall Stack (MCS) register, and an eight-level hardware stack for PC 
storage. The program counter contains the address of the currently executing 
instruction, either on-chip or off-chip, and the prefetch counter is used for fetching 
instructions. The eight-level stack is used during interrupts and subroutines, and the 
MCS is used to store the contents of the PFC during BLKD/BLKP, MAC/MACD, 
and TBLR/TBLW instructions. 


The contents of the accumulator may be loaded into the PC in order to implement 
“computed go to” operations. The TMS320C25 includes push and pop instructions 
for nesting of subroutines/interrupts beyond eight levels by allowing a stack to be 
built in data memory. These instructions store the top of the stack into data memory 
or load it into the accumulator. 


The TMS320C25 local memory interface consists of a 16-bit parallel data bus 
(D15-D0), a 16-bit program address bus (A15-A0), three pins for data/program 
memory or |/O space select (DS, PS, and 1S), and various system control signals. 
The R/W signal controls the direction of a data transfer, and STRB provides a timing 
signal to control the transfer. When using on-chip program RAM, ROM, or high- 
speed external program memory, the TMS320C25 runs at full speed without wait 
states. The use of a READY signal allows wait-state generation for communicating 
with slower off-chip memories. 





The TMS320C25 supports Direct Memory Access (DMA) to its external 
program/data memory using the HOLD and HOLDA signals. Another processor can 
take complete control of the TMS320C25's external memory by asserting HOLD low. 
This causes the TMS320C25 to place its address, data, and control lines in the 
high-impedance state. Signaling between the external processor and the 
TMS320C25 can be performed using interrupts. Two modes are available on the 
device. In the TMS32020-like mode, execution is suspended during assertion of 
HOLD. In the new "concurrent DMA” mode, the TMS320C25 continues to execute 
its program while operating from internal RAM or ROM, thus greatly increasing 
throughput in data-intensive applications. 
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2.4 Central Arithmetic Logié Unit /(CALU) - 


The TMS320C25 CALU contains a 16- bit scaling shifter, a 16 x 16-bit parallel 
multiplier, a 32-bit Arithmetic Logic Unit (ALU), a 32-bit accumulator, and some | 
additional scalers available at the outputs of both the accumulator and the multiplier. 


The following steps occur in the implementation of a typical ALU instruction: 


1) Data is fetched from the RAM on the data bus, 
2) Data is passed through the scaling shifter and the ALU where the arithmetic is 
performed, and | 


3) ~The result is moved into the accumulator. 


One input to the ALU is always provided from the accumulator, and the other input 
may be transferred from the Product Register (PR) of the multiplier or the scaling 
shifter which is loaded from data memory. 


The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 


32-bit output connected to the ALU. The scaling shifter produces a left-shift of 0 


to 16 bits on the input data, as programmed in the instruction. The LSBs of the output 
are filled with zeros, and the MSBs may be either filled with zeros or sign-extended, 
depending upon the state of the sign-extension mode bit of status register ST1. 
Additional shift capabilities enable the processor to perform numerical scaling, bit 
extraction, extended arithmetic, and overflow prevention. 


The TMS320C25 32-bit ALU and accumulator perform a wide range of arithmetic 


-and logical instructions, the majority of which execute in a single clock cycle. The 


overflow saturation mode may be programmed through the SOVM and ROVM 
(set/reset overflow mode) instructions. When the accumulator is in the overflow 
saturation mode and an overflow occurs, an overflow flag is set and the accumulator 
is loaded with the most positive/negative number depending upon the direction of 
overflow. 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory: 
ACCH (accumulator high) and ACCL (accumulator low). Additional shifters at the 
Output of the accumulator provide a shift of 0 to 7 places to the left. This shift is 
performed while the data is being transferred to the data bus for storage. The contents 
of the accumulator remain unchanged. The accumulator also has an in-place one-bit 
shift to the left or right (SFL or SFR instructions) and rotate through carry (ROL or 
ROR instructions) for shifting the contents of the accumulator. 


A carry bit has been added to the TMS320C25 to facilitate multiple-precision arith- 
metic. The carry bit is affected by all add and subtract instructions. Two new 
instructions, ADDC (add with carry) and SUBB (subtract wth borrow), use the carry 
bit when computing a result. 


The TMS320C25 utilizes a 16 x 16-bit hardware multiplier, which is capable of 


computing a 32-bit product during every machine cycle. Two registers are associated 
with the multiplier. 


@ A 16- bit Temporary Register (TR) that holds one of the operands for the 
- multiplier, and | 
@ A 32-bit Product Register (PR) that holds the product. 


The output of the product register can be left-shifted 1 or 4 bits. This is useful for 
implementing fractional arithmetic or justifying fractional products. The output of the 
PR can also be right-shifted 6 bits to enable the execution of up to 128 consecutive 
multiply/accumulates without overflow. 


An unsigned multiply (MPYU) instruction facilitates extended-precision multipli- 
cation. The unsigned contents of the T register are multiplied by the unsigned 
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2.5 System 


contents of the addressed data memory location, with the result placed in the P 
register. 


Two multiply/accumulate instructions (MAC and MACD) fully utilize the computa- 
tional bandwidth of the multiplier, allowing both operands to be processed simul- 
taneously. For MAC and MACD, two operands are transferred to the multiplier each 
cycle via the program and data buses. This provides for single-cycle 
multiply/accumulates when used with repeat (RPT or RPTK) instructions. The 
program bus can supply data from internal or external memory (RAM or ROM) and 
still maintain single-cycle operation. The SQRA (square/add) and SQRS 
(square/subtract) instructions pass the same value to both inputs of the multiplier 
for squaring a data memory value. 


The TMS320C25 supports floating-point operations for applications requiring a large 
dynamic range. A normalization (NORM) instruction is used to normalize fixed-point 
numbers contained in the accumulator by performing left shifts. The LACT (load 
accumulator with shift specified by the T register) instruction denormalizes a float- 
ing-point number by arithmetically left-shifting the mantissa through the input 
scaling shifter. The ADDT and SUBT instructions have also been provided to allow 
additional arithmetic operations with shift specified by the T register. Floating-point 
numbers with 16-bit mantissas and 4-bit exponents can thus be manipulated. 


The device has a variety of branch instructions that are interpreted according to the 
status of the ALU. Bit test instructions (BIT and BITT) have also been included, 
which do not affect the accumulator but allow the testing of a specified bit of a word 
in data memory. 


Control 


Control operations are provided on the TMS320C25 by an on-chip timer, a repeat 
counter, three external maskable user interrupts, and internal interrupts generated 
by serial port operations or by the timer. 


The TMS320C25 provides a memory-mapped 16-bit timer (TIM) register that is a 
down counter continuously clocked by CLKOUT1. A timer interrupt (TINT) is 
generated whenever the timer decrements to zero. The timer is reloaded with the value 
contained in the period (PRD) register within the next cycle after it reaches zero so 
that interrupts may be programmed to occur at regular intervals of (PRD + 1) x 
CLKOUT1 cycles. This feature is useful for control operations and for synchronously 
sampling or writing to peripherals. 


The TMS320C25 design includes a repeat feature that allows a single instruction to 
be performed up to 256 times. The repeat counter (RPTC) is loaded with either a 
data memory value (in the case of the RPT instruction) or an immediate value (in 
the case of the RPTK instruction). The repeat feature can be used with instructions 
such as multiply/accumulates, block moves, |/O transfers, and table read/writes. 
Those instructions that are normally multicycle are pipelined when using the repeat 
feature, and effectively become single-cycle instructions. For example, the table read 
(TBLR) instruction ordinarily takes four cycles, but when repeated, a table location 
can be read every cycle. 


The TMS320C25 has three external maskable user interrupts (INT2-INTO) available 
for external devices that interrupt the processor. Internal interrupts are generated 
by either the serial port, the timer, or the software interrupt instruction. Interrupts 
are prioritized with reset having the highest priority and the serial port transmit 
interrupt having the lowest priority. 
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The conditions and modes of the TMS320C25 are stored in the two status registers, 
~ STO and ST1. Instructions allow for storing and loading the status registers into and 


from data memory. In this manner, the current status of the device may be saved 
aug interrupts and pup OTe calls. | 


2.6 1/O Interface 


The TMS320C25 supports a wide range of system interfacing requirements. Three 


separate address spaces (program, data, and I/O) provide interfacing to memory and 
I/O, thus maximizing system throughput. I/O design is simplified by having |/O 
treated the same way as memory. |/O devices are mapped into the I/O address space 
using the processor’s external address and data buses in the same manner as 
memory-mapped devices. Interfacing to memory and I/O devices of varying speeds 


is accomplished by using the READY line. 


The TMS320C25 I/O space consists of 16 input and 16 output ports. These ports 
provide the full 16-bit parallel |/O interface via the data bus on the device. A single 
input or output operation typically takes two cycles; however, when used with the 
repeat counter, the operation becomes single-cycle. 


An on-chip serial port provides direct communication with serial devices such as 
codecs, serial A/D converters, and other serial systems. The interface signals are 
compatible with codecs and many other serial devices with a minimum of external 
hardware. The two serial port memory-mapped registers (the data transmit/receive 
registers) may be operated in either an 8-bit byte or 16-bit word mode. The transmit 
framing synchronization pulse can be generated internally or externally. The maxi- 
mum speed of the serial port is 5 MHz. 


The primary enhancements of the TMS320C25's serial port over the TMS32020 are: 


e Double-buffering for both receive and transmit operations, thus allowing a 
continuous bit stream even if FSX is an output, 
@ No minimum CLKR/CLKX frequency (fmjn = 0 Hz), and 
@ Frame sync mode (FSM) bit, which allows continuous operation with no frame 
‘synchronization pulses. 


The frame sync mode is useful in communicating to "PCM highways.” For AT&T 
T1 and CCITT G711/712 lines, the TMS320C25 can easily be made to communicate 
directly in these formats by counting the transmitted/received bytes in software and 
performing SFSM/RFSM instructions as needed to set/reset the FSM bit. 


2.7 System Configurations 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of 


system requirements. The TMS320C25 can be used as follows: 


@ A standalone system (a single Processok using 4K words of on-chip ROM and 
544 words of on-chip RAM), 

@ = Parallel multiprocessing systems with shared global data memory, or 

® Host/peripheral coprocessing using interface control signals. 


The standalone hardware system interface consists of a 16-bit parallel data bus, a 
16-bit address bus, three pins for memory space select, and various system control 
signals. In Figure 2-4, an external data RAM and a PROM/EPROM have been added 
to the minimum processing system. The READY signal allows wait-state generation 
for communicating with slower off-chip memories. All the memories and |/O devices 
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are directly controlled by the TMS320C25, thus minimizing external hardware 
requirements. 
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Figure 2-4. A Minimum Processing System 


The serial port can interface to serial devices such as codecs and serial A/D - 
converters. Serial communication can also be used between processors, e.g., to 
connect two minimal systems together to make a multiprocessing system. 


For multiprocessing applications, the TMS320C25 has the capability of allocating 
global data memory space and communicating with that space via the BR (bus 
request) and READY control signals. The 8-bit memory-mapped global memory 
allocation register (GREG) specifies up to 32K words of the TMS320C25’s data 
memory as global external memory. The contents of the register determine the size 
of the global memory space. If the current instruction addresses an operand within 
that space, BR is asserted to request control of the bus. The length of the memory 
cycle is controlled by the READY line. 


In a multiprocessing system using global memory, the address space of each 
processor is divided into local and global sections. Global memory can be used for 
common data memory storage. 


Figure 2-5 shows a configuration for a parallel processing system using global 
memory. Two TMS320C25s share a global data memory while executing from local 
program memory. The arbitration for the global memory is handled in software by 
using the XF and BIO pins. The XF pin acts as an external flag, and the BIO pin can 
be polled by a branch (BIOZ) instruction whose condition depends on the state of 
BIO. 
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Figure 2-5. Global Memory Parallel Processing 


Multiprocessing with the TMS320C25 may also be accomplished through the use 
of two sets of interface control signals: HOLD/HOLDA and interrupts. HOLD/HOLDA 
(hold/hold acknowledge) signals allow another microprocessor to read from or write 
to the local off-chip data/program memory of the temporarily halted processor. Using 
these signals to implement direct memory access is useful for downloading to or 
initializing the TMS320C25. In interrupt-driven multiprocessing, time-critical oper- 
ations can be protected by masking out interrupts. 


The TMS320C25 has been enhanced to provide a new hold mode that provides the 
ability to perform concurrent DMA. The new hold mode has been defined so that if 
the device is executing from on-chip program memory (ROM or RAM) and HOLD 
is asserted, the device is not halted, but instead proceeds with program execution 
until an external access must be made. This greatly enhances system throughput in 
multiprocessing applications. 


Many applications require a digital signal processing-type peripheral interface to a 
general-purpose 16- or 16/32-bit microcomputer. Such configurations are often 
useful when a general-purpose system is already available. A host/peripheral 
configuration using the interface control signals of HOLD/HOLDA is shown in Figure 
2-6. 
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Figure 2-6. Host/Peripheral Coprocessing Using Interface Control Signals 


A great advantage to using the TMS320C25 in a multiprocessor system is its ability 
to be synchronized to an external signal. A special SYNC pin allows the internal clocks 
of two or more TMS320C25s to be synchronized. Since the processors operate on 
the same internal clock phase, all external signals will also be synchronized, elimi- 
nating the need for external logic to synchronize interprocessor signals. 





2.8 Addressing Modes and Instructions 


The TMS320C25 instruction set supports numeric-intensive signal processing 
operations as well as general-purpose applications such as multiprocessing and 
high-speed control. The TMS320C25 is completely object code upward-compatible 
with the TMS32020 so that TMS32020 programs run unmodified on the 
TMS320C25. The TMS32010 source code is upward-compatible with the 
TMS320C25 source code. 


For maximum throughput, the current instruction is executed while the next 
instruction is decoded and the one following that is prefetched. Since the same data 
lines are used to communicate to external data/program or |/O space, the number 
of cycles may vary depending upon whether the next data operand fetch is from 
internal or external memory. Highest throughput is achieved by maintaining data 
memory on-chip and using either internal or fast external program memory. 
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Three memory addressing modes are available with the TMS320C25 instruction set: 
direct, indirect, and immediate addressing. Both direct and indirect addressing can 
be used to access data memory. When using direct addressing, seven bits of the 
instruction word are concatenated with the nine bits of the Data memory page Pointer 
(DP) to form the 16-bit data memory address. With a 128-word page length, the 
DP register points to one of 512 possible data memory pages to obtain a 64K total 
data memory space. The seven-bit address in the instruction points to the specific © 
location within the data memory page. Direct addressing can be used with all 
instructions except CALL, the branch instructions, immediate operand instructions, 
and instructions with no operands. 


Flexible and powerful indirect addressing is provided by the eight auxiliary registers 
(ARO-AR7). The data address to be used in an instruction is placed into one of eight 
auxiliary registers. To select a specific auxiliary register, the Auxiliary Register Pointer 
(ARP) is loaded with a value from 0 through 7, designating ARO through AR7, 
respectively. The ARAU implements 16-bit unsigned arithmetic, performing auxiliary 
register arithmetic operations in the same cycle as the execution of the instruction. 


There are seven types of indirect addressing: indexing with either increment or 
decrement, indexing by either adding or subtracting the contents of ARO, indexing 
by either adding or subtracting the contents of ARO with the carry propagation 
reversed (for FFTs), or no indexing (see Table 2-2). All indexing operations are 
performed on the current auxiliary register in the same cycle as the original instruction, 
with an optional new ARP value being loaded. 


Bit-reversed indexed addressing modes allow efficient |/O to be performed for the 
resequencing of data points in a radix-2 FFT program. The direction of carry propa- 
gation in the ARAU is reversed when this mode is selected and ARO is added 
to/subtracted from the current auxiliary register. Typical use of this addressing mode 
requires that ARO first be set to a value corresponding to one-half of the array size, 
and AR (ARP) be set to the base address of the data (the first data point). 


Table 2-2. Addressing Modes 


ADDRESSING MODE OPERATION 


OPA Direct addressing 

OP *(,NARP) Indirect; no change to AR. 

OP *+(,NARP) Indirect; current AR is incremented. 
OP *-(,NARP) Indirect; current AR is decremented. 


OP *0+(,NARP) | Indirect; ARO is added to current AR. 

OP *0-(,NARP) Indirect; ARO is subtracted from current AR. 

OP “BRO+(,NARP) Indirect; ARO is added to current AR (with 

| reverse carry propagation). 

OP *BRO-(,NARP) Indirect; ARO is subtracted from current AR 
(with reverse carry propagation). 


NOTE: The optional NARP field specifies a new value of the ARP. 





In immediate addressing, the instruction word contains the value of the immediate 
operand. The TMS320C25 has both single-word (8-bit and 13-bit constant) short 
immediate instructions and two-word (16-bit constant) long immediate instructions. 
In the case of long (16-bit constant) immediate instructions, the word following the 
instruction opcode is used as the immediate operand. Included in the TMS320C25's 
instruction set are 17 immediate operand instructions. | 


Table 2-3 defines the symbols and abbreviations used in the operation portion of the 
list of TMS320C25 instructions (Table 2-4). 
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Table 2-3. Instruction Symbols 


symeol | —~=~=~“~*~“~*~sEANING 


Accumulator 

Auxiliary register pointer buffer 

Auxiliary Register n (ARO through AR7 are predefined 
assembler symbols equal to 0 through 7, respectively.) 
Auxiliary register pointer 

Branch control input 

Carry bit 

2-bit field specifying compare mode 

On-chip RAM configuration contro! bit 

Data memory address 

Data page pointer 

Format status bit 

Frame synchronization mode bit 

Hold mode bit 

Interrupt mode flag bit 

Indicates nn is a hexadecimal number. (All others are 
assumed to be decimal values.) 

Overflow flag bit 

Overflow mode bit 

Product register 

Port address. (PAO through PA15 are predefined assembler 
symbols equal to 0 through 15, respectively.) 
Program counter 

2-bit field specifying P register output shift code 
Program memory address 

Product register 

Repeat counter 

Status Register n (STO or ST1) 

Sign-extension mode bit 

Temporary register 

Test control bit 

Top of stack 

Temporary register 

Transmit mode bit 

Unsigned value 

XF pin status bit 

Is assigned to 

An absolute value 

Optional items 

Contents of 





Twenty-four new instructions have been added to the TMS320C25 instruction set 
to improve overall processor throughput and ease of use. These new instructions can 
be categorized into the following four groups: 


Extended-precision arithmetic (ADDC, SUBB, MPYU, BC, BNC, SC, RC) 
Adaptive filtering (MPYA, MPYS, ZALR) 

Control and |1/O (SHM, RHM, STC, RTC, SFSM, RFSM) 

Accumulator and register instructions (SPH, SPL, ADDK, SUBK, ADRK, SBRK, 
ROL, ROR) 


The list of TMS320C25 instructions in Table 2-4 is organized according to function 
and alphabetized within each functional grouping. The symbol (T) indicates 
instructions that are not included in the TMS32010 instruction set, and the symbol 
(+) those not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 


NO. 
MNEMONIC DESCRIPTION | | 
mmewowe = escmiprion WORDS |}. ee 


ABS 
ADD 
Abpc?t 
ADDH 
ADDK?+ 
ADDS 







AbptTt 









ADLKT 
AND 





ANDKt 


CMPLt 
LAC 
LACK 
LAcTt 
LALKT 
NEGT 
NoRMt 
OR 
ORKt 





ROL? 





ROR? 


SACH 
SACL 
SBLKT 
SFLT 

SFRT 

SUB 

SUBBt 
SUBC 
SUBH 
SUBK # 
SUBS 


SuBTT 


XOR 
xorRKt 






ZAC 
ZALH 
| ZALR* 





ZALS 











Absolute value of accumulator > 

Add to accumulator with shift 

Add to accumulator with carry 

Add to high accumulator 

Add to accumulator short immediate 

Add to low accumulator with sign 

extension suppressed 

Add to accumulator with shift specified by 

T register 

Add to accumulator long immediate with shift 
AND with accumulator 


AND immediate with accumulator with shift 





Complement accumulator 

Load accumulator with shift 

Load accumulator immediate short 

Load accumulator with shift specified by T register 
Load accumulator long immediate with shift 
Negate accumulator 

Normalize contents of accumulator 

OR with accumulator 

OR immediate with accumulator with shift 


Rotate accumulator left 


Rotate accumulator right 





Store high accumulator with shift 
Store low accumulator with shift 
Subtract from accumulator long immediate with shift 
Shift accumulator left 

Shift accumulator right 

Subtract from accumulator with shift 

Subtract from accumulator with borrow 

Conditional subtract 

Subtract from high accumulator 

Subtract from accumulator short immediate 
Subtract from low accumulator with sign 

extension suppressed 

Subtract from accumulator with shift specified by 

T register 

Exclusive-OR with accumulator 

Exclusive-OR immediate with accumulator with shift 


Zero accumulator 

Zero low accumulator and load high accumulator 
Zero low accumulator and load high accumulator 
with rounding | 
Zero accumulator and load low accumulator with 
sign extension suppressed . 



























|(ACC)| - ACC 
(ACC) + [(dma) x 2shift) + ACC 
(ACC) + (dma) + (C) ~ ACC 
(ACC) + [(dma) x 216] + ACC 
(ACC) + 8-bit constant ~ ACC 
(ACC) + (dma) ~ ACC 








(ACC) + [(dma) x 2(Treg)} + ACC 


(ACC) + [16-bit constant x 2shift] - ACC 

(ACC(15-0)). AND.(dma) —~ ACC(15-0), 
0 —~ ACC(31-16) 

(ACC)30-0)). AND.[16-bit constant x 2shift] + 
ACC(30-0), O > ACC(30-0) 

(ACC) > ACC 

(dma) x 2shift — ACC 

8-bit constant ~ ACC 

(dma) x 2(Treg) = ACC 

(16-bit constant) x 216 + ACC 

—(ACC) ~ ACC 
































(ACC(15-0)).OR. (dma) ~ ACC(15-0) 

(ACC(30-0)).OR.[16-bit constant x 2shift) > 
ACC(30-0) 

(ACC(30-0)) > ACC(31-1), (C) ~ ACC(O), 
(ACC(31)) > C 

(ACC(31-1)) ~ ACC(30-0), (C) > ACC(31), 
(ACC(O)) + C 

((ACC) x 2shift) + dma 

[(ACCL) x 2shift] + dma 

(ACC) — [16-bit constant x 2shift] + ACC 
(ACC(30-0)) > ACC(31-1), O + ACC(O) 
(ACC(31-1)) ~ ACC(30-0), (ACC(31)) ~ ACC(31) 
(ACC) — [(dma) x 2shift) - ACC 

(ACC) — (dma) — (C) > ACC 


RO —] =] —| Oo —| -—- —- = 









































(ACC) — [(dma). x 216] > ACC 
(ACC) — 8-bit constant — ACC 
(ACC) (dma) ~ ACC 


_—= =— =| -—@ me =| = mm AQ | — 



















(ACC) — [(dma) x 2(Treg)] - ACC 











(ACC(15-0)).XOR. (dma) ~ ACC(15-0) 
(ACC(30-0)).XOR.[16-bit constant x 2shift) + 
ACC(30-0) 

0 - ACC 

(dma) x 216 > ACC 

(dma) x 216 + >8000- ACC 




















(dma) — ACCL, 0 ~ ACCH 


TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 


2-18 


Architectural Overview 





Table 2-4. TMS320C25 Instructions (Continued) 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


NO. 
MNEMONIC DESCRIPTION OPERATION 
WORDS 
1 


Add to auxiliary register short immediate (ARn) + 8-bit constant ~ ARn 
lf ARn | CM | ARO, then 1 — TC; else O > TC 








CMPRt Compare auxiliary register with auxiliary register ARO 














T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


NO. 
OPERATION 
WORDS 


MNEMONIC 


Load auxiliary register 


Store auxiliary register 
Subtract from auxiliary register short immediate 


DESCRIPTION 


Add P register to accumulator 

Load high P register 

Load T register 

Load T register and accumulate previous product 
Load T register, accumulate previous product, 

and move data 

Load T register and store P register in accumulator 
Load T register and subtract previous product 
Multiply and accumulate 


Multiply and accumulate with data move 


Multiply (with T register, store product in P register) 
Multiply and accumulate previous product 


Multiply immediate 
Multiply and subtract previous product 


Multiply unsigned 

Load accumulator with P register 
Subtract P register from accumulator 
Store high P register 

Store low P register 


Set P register output shift mode 


Square and accumulate 


Square and subtract previous product 


= x2 ese AQ =| —| —-—| —- = — 


(dma) — (ARn) 


LARK Load auxiliary register short immediate 8-bit constant — ARn 

LARP Load auxiliary register pointer 3-bit constant —~ ARP, (ARP) — ARB 
LDP Load data memory page pointer (dma) —~ DP 

LDPK Load data memory page pointer immediate 9-bit constant —~ DP 

LRLKT Load auxiliary register long immediate 16-bit constant — ARn 

MAR Modify auxiliary register 


(ARn) — dma | 
(ARn) — 8-bit constant — ARn 





(ACC) + (shift Preg) ~ ACC 
(dma) — Preg (31-16) 
(dma) — Treg 
(dma) — Treg, (ACC) + (shifted Preg) ~ ACC 
(dma) — Treg, (dma) ~ dma + 1, 
(ACC) + (shifted Preg) ~ ACC 
(dma) — Treg, (shifted Preg) ~ ACC 
(dma) — Treg, (ACC) — (shifted Preg) ~ ACC 
(ACC) + (shifted Preg) ~ ACC, 
(pma) x (dma) — Preg 
(ACC) + (shifted Preg) ~ ACC, 
(pma) x (dma) — Preg, (dma) ~ dma + 1 
(Treg) x (dma) — Preg 
(ACC) + (shifted Preg) ~ ACC, 
(Treg) x (dma) — Preg 
(Treg) x 13-bit constant — Preg 
(ACC) — (shifted Preg) ~ ACC, 
(Treg) x (dma) — Preg 
Usgn (Treg) x Usgn (dma) — Preg 
(shifted Preg) ~ ACC 
(ACC) — (shifted Preg) ~ ACC 
(shifted Preg (31-16)) ~ dma 
(shifted Preg (15-0)) —~ dma 
2-bit constant — PM 
(ACC) + (shifted Preg) ~ ACC, 
(dma) x (dma) — Preg 
(ACC) — (shifted Preg) ~ ACC, 
(dma) x (dma) — Preg 





TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions (Continued) 





BRANCH/CALL INSTRUCTIONS 


} NO. | ) ) 
MNEMONIC oo. DESCRIPTION : OPERATION 2% 
WORDS | : | 


Branch unconditionally pma — PC 

Branch to address specified by accumulator (ACC(1 5-0)) = PG 

Branch on auxiliary register not zero If (AR(ARP)) # O, then pma ~ PC; else (PC) + 2 ->- 
. PC | | 

If (TC) = 1, then pma — PC; else (PC) + 2 — PC 

If (TC) = O, then pma — PC; else (PC) + 2 — PC 

If (C) = 1, then pma — PC; else (PC) + 2 — PC 

If (ACC) > O, then pma — PC; else (PC) + 2 — PC 

If (ACC) > 0, then pma > PC; else (PC) +2 > PC 

lf (BIO) = 0, then pma — PC; else (PC) + 2 > PC 

If (ACC) < O, then pma — PC; else (PC) + 2 > PC 

If (ACC) < O, then pma — PC; else (PC) + 2 ~ PC 

If (C) = 0, then pma — PC; else (PC) + 2 — PC 

If (OV) # O, then pma — PC; else (PC) + 2 — PC 

If (ACC) # O, then pma — PC; else (PC) + 2 — PC 

If (OV) = O, then pma — PC; else (PC) + 2 > PC 

If (ACC) = O, then pma — PC; else (PC) + 2 ~ PC 

(ACC(15-0)) > PC, (PC) + 1 —~ TOS 

(PC) + 2 > TOS, pma > PC 

Return from subroutine (TOS) > PC 


1/0 AND DATA MEMORY i 
NIC DESCRIPT OPERATION 


Block move from data memory to data memory (dma1, addressed by PC) ~ dma2 
(pma, addressed by PC) > dma 

(dma) ~ dma + 1 

1-bit constant ~ FO 

(data bus, addressed by PA) — dma 
(dma) — data bus, addressed by PA 

0 — FSM 

O —- TXM 

O — XF 

1— FSM 

1—> TXM 

1 — XF 

(pma, addressed by ACC (15-0)) > dma 
(dma) — pma, addressed by ACC (15-0) 


Branch if TC bit + O 
Branch if TC bit = O 
Branch on carry 
Branch if accumulator > O° 
- Branch if accumulator > O 
Branch on 1|/O status = O 
Branch if accumulator < O 
Branch if accumulator < O 
Branch on no carry 
Branch if no overflow 
Branch if accumulator 
Branch on overflow 
Branch if accumulator = 
Call subroutine indirect 
Call subroutine 


"> HNO —|- NNN NY NH NH HY NB NH NH NH HD NY 





Block move from program memory to data memory 
Data move in data memory © 

Format serial port registers 

Input data from port 

Output data to port 

Reset serial port frame synchronization mode 
Reset serial port transmit mode 

Reset external flag 


Set serial port frame synchronization mode 


Set serial port transmit mode 
Set external flag 

Table read 

Table write 


- Se i a ee ia aia se a COC“? 





TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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Table 2-4. TMS320C25 Instructions (Concluded) 


CONTROL INSTRUCTIONS 


NO. 
MNEMONIC _ DESCRIPTION WORDS OPERATIONS 


BIT 
BITTT 
CNFDt 
CNFPt 
DINT 
EINT 
IDLET 
LST 
tsTit 
NOP 
POP 
poppt 
PSHDt 
PUSH 
Rc 
RHM+ 
ROVM 
RpTt 
RPTKT 
RSxmt 
RTC# 
sc 
SHM+ 
SOVM 
SST 
ssTit 
ssxmt 
stc# 
TRAPt 


tThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 


Test bit 

Test bit specified by T register 
Configure block as data memory 
Configure block as program memory 
Disable interrupt 

Enable interrupt 

Idle until interrupt 

Load status register STO 

Load status register ST 1 

No operation 

Pop top of stack to low accumulator 
Pop top of stack to data memory 
Push data memory value onto stack 
Push low accumulator onto stack 
Reset carry bit 

Reset hold mode 

Reset overflow mode 

Repeat instruction as specified by data memory value 
Repeat instruction as specified by immediate value 
Reset sign-extension mode 

Reset test/control flag 

Set carry bit 

Set hold mode 

Set overflow mode 

Store status register STO 


‘Store status register ST 1 


Set sign-extension mode 
Set test/control flag 
Software interrupt 


_ 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1. 
1 
1 
1 
1 
1 
1 
1 


(dma bit at (15-bit code)) — TC 
(dma bit at (15-Treg)) ~ TC 
O — CNF 

1 — CNF 

1 — INTM 

0 - INTM 

(PC) + 1 — PC, powerdown 
(dma) ~ STO 

(dma) —~ ST1 

(PC) + 1—- PC 

(TOS) — ACC 

(TOS) ~ dma 

(dma) ~ TOS 

(ACCL) ~ TOS 

0o-C 

0 —- HM 

0 — OVM 

(dma) — RPTC 

8-bit constant — RPTC 

O — SXM 

0-TC 

Tie 

1— HM 

1—+ OVM 

STO — dma 

ST1— dma 

1—7 SXM 

1+ TC 

(PC) + 1 + TOS, 30 — PC 
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2.9 Development Support 
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Texas Instruments offers extensive development support and documentation for the 
TMS320 family (see Figure 2-7). Sophisticated development operations are 
performed with the TMS320C25 Macro Assembler/Linker, Simulator, and Emulator 
to evaluate the performance of the processor, develop algorithms, and fully integrate 
the design’s software and hardware modules. Since the TMS320C25 is pin-com- 
patible with the TMS32020, development can begin immediately by utilizing the 
broad base of TMS32020 support tools (see Appendix F). : | 


Extensive documentation, including application reports, user’s guides, and textbooks, 
is available to support DSP design, research, and education. When questions arise, 
additional support can be obtained by contacting the Texas Instruments Customer 
Response Center (CRC) hotline number, 1-800-232-3200. 





Figure 2-7. TMS320 Family Development Support 
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TMS320C25 MACRO ASSEMBLER/LINKER 


The TMS320C25 Macro Assembler translates TMS320C25 assembly language 
source code into executable object code. The assembler allows the programmer to 
work with mnemonics rather than hexadecimal machine instructions and to reference 
memory locations with symbolic addresses. The macro assembler supports macro 
calls and definitions along with conditional assembly. 


The TMS320C25 Linker permits a program to be designed and implemented in 
separate modules that will later be linked together to form the complete program. 
The linker resolves external definitions and references for relocatable code, creating 
an object file that can be executed by the TMS320C25 Simulator, TMS320C25 
Emulator, or TMS320C25 processor. 


The TMS320C25 Macro Assembler/Linker is supported on the VAX/VMS, TI 
PC/MS-DOS, and IBM PC/PC-DOS operating systems. 


TMS320C25 SIMULATOR 


The TMS320C25 Simulator is a software program that simulates operation of the 
TMS320C25 to allow program verification. The debug mode enables the user to 
monitor the state of the simulated TMS320C25 while the program is executing. The 
simulator uses the TMS320C25 object code produced by the TMS320C25 Macro 
Assembler/Linker. During program execution, the internal registers and memory of 
the simulated TMS320C25 are modified as each instruction is interpreted by the host 
computer. Once program execution is suspended, the internal registers and both 
program and data memories can be inspected and/or modified. 


~The TMS320C25 Simulator is supported on the VAX/VMS, Tl PC/MS-DOS, and IBM 
PC/PC-DOS operating systems. 


TMS320C25 EMULATOR 


The TMS320C25 Emulator (XDS/22) is a user-friendly system that has all the 
features necessary for realtime in-circuit emulation. This allows integration of the 
hardware and software modules in the debug mode. By setting breakpoints based 
on internal conditions or external events, execution of the program can be suspended 
and control given to the debug mode. In the debug mode, all registers and memory 
locations can be inspected and modified. Single-step execution is available. Full 
trace capabilities at full speed and a reverse assembler that translates machine code 
back into assembly instructions also increase debugging productivity. 


The TMS320C25 Emulator is a completely self-contained system. With three 
RS-232-C ports, it can be interfaced to a terminal, host computer for source or object 
downloading/uploading capabilities, and printer or PROM programmer. The 
emulator has 4K x 16-bit words of high-speed static RAM (zero wait states) for 
program memory. The XDS/22 also supports memory expansion by including 64K 
words of DRAM. This slower memory is configurable by the user as either all program 
memory, all data memory, or 32K words of each. 
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3. Device Operation 


The TMS320C25 microprocessor architectural design emphasizes overall speed, 
communication, and flexibility in processor configuration. Control signals and 
instructions provide block-memory transfers, communication to slower off-chip 
devices, and multiprocessing implementations. Increased throughput for many digital 
signal processing (DSP) applications is accomplished by _ single-cycle 
multiply/accumulate instructions, two large on-chip RAM blocks, eight auxiliary 
registers with a dedicated arithmetic unit, a serial port, hardware timer, faster |/O for 
data-intensive signal processing, and many other features. Figure 2-1 shows the 
functional block diagram of the TMS320C25 processor. 


Major topics discussed in this section are listed below. 
@ Internal Hardware Summary (Section 3.1 on page 3-3) 


@ Memory Organization (Section 3.2 on page 3-5) 
On-chip program ROM 
On-chip data RAM blocks 
Memory maps 
Memory-mapped registers 
Auxiliary registers 
Addressing modes 
Memory-to-memory moves 


@ Central Arithmetic Logic Unit (CALU) (Section 3.3 on page 3-13) 
Scaling shifter 
ALU and accumulator 
Multiplier, T and P registers 


@ System Control (Section 3.4 on page 3-18) 
Program counter and related hardware 
Reset 
Status registers 
Timer operation 
Repeat counter 
Powerdown mode 


® External Memory and |/O Interface (Section 3.5 on page 3-26) 
Internal clock timing relationships 
External read and write cycles 
Wait states 


@ Interrupts (Section 3.6 on page 3-31) 
Interrupt operation 
External interrupt interface 


@ = Serial Port (Section 3.7 on page 3-35) 
Transmit and receive operations 


e Multiprocessing and Direct Memory Access (Section 3.8 on page 3-44) 
Synchronization 
Global memory 
The hold function 


@ General-Purpose I/O Pins (Section 3.9 on page 3-49) 


BIO input 
External flag output 
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DR 
CLKR 
FSR 
DX 
CLKX 
FSX 


16 
$T0(16) 
ST 1(16) 
RPTC(8) 
DRR(16) 
TIM(16) 
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A15-A0 
D15-DO 


Global memory allocation register 
Serial port receive shift register 
Serial port transmit shift register 


Repeat instruction counter 


Status registers 


Program counter 
= Prefetch counter 


PC 

PFC 

RPTC 

GREG 

RSR 

XSR 

ARO-AR7 = Auxiliary registers 
STO,ST1 


interrupt mask register 


Interrupt flag register 
= Instruction register 


Microcall stack 
= Queue instruction register 


= Product register 
= Period register for timer 


= Timer 
= Temporary register 


1FR 
IMR 
IR 
MCS 
QIR 
PR 
PRD 
TIM 
TR 


Figure 3-1. TMS320C25 Block Diagram 


= Auxiliary register arithmetic unit 
Auxiliary register pointer buffer 

= Auxiliary register pointer 

= Data memory page pointer 

= Serial port data receive register 
Serial port data transmit register 


= Accumulator low 
= Arithmetic logic unit 


ACCH = Accumulator high 


LEGEND: 
ACCL 
ALU 
ARAU 
ARB 
ARP 
DP 
DORR 
DXR 


3-2 


Device Operation 


3.1 Internal Hardware Summary 


The TMS320C25 internal hardware implements functions that other processors 
typically perform in software or microcode. For example, the device contains 
hardware for single-cycle 16 x 16-bit multiplication, data shifting, and address 
manipulation. This hardware-intensive approach provides computing power previ- 
ously unavailable on a single chip. 


Table 3-1 presents a summary of the TMS320C25 internal hardware. This summary 
table, which includes the internal processing elements, registers, and buses, is 
alphabetized within each functional grouping. All of the symbols used in this table 
correspond to the symbols used in the block diagram of Figure 3-1, the succeeding 
block diagrams in this section, and the text throughout this document. 


Table 3-1. Internal Hardware 


UNIT SYMBOL FUNCTION 


PROCESSING ELEMENTS 
A 32-bit two’s-complement arithmetic logic unit having two 32-bit input ports 
and one 32-bit output port feeding the accumulator. 
The grouping of the ALU, multiplier, accumulator, and scaling shifter. 
nit 
A 16 x 16-bit parallel multiplier. 
A 16-bit memory-mapped register used to reload the timer. 


Program Counter PC (15-0) A 16-bit program counter used to address program memory. The PC always 
contains the address of the next instruction to be executed. The PC contents 
are updated following each instruction decode operation. 
Prefetch Counter PFC (15-0) 
when using the block move (BLKD and BLKP), multiply/accumulate (MAC 
and MACD), and table read/write (TBLR and TBLW) instructions. 
Random Access Memory | RAM (BO) A RAM block with 256 x 16 locations configured either as data or program 
(data or program) memory. 
Random Access Memory | RAM (B1) A data RAM block, organized as 256 x 16 locations. 
(data only) 
Random Access Memory | RAM (B2) A data RAM block, organized as 32 x 16 locations. 
(data only) 
Auxiliary Register ARAU A 16-bit unsigned arithmetic unit used to perform operations on auxiliary 
Arithmetic Unit register data. 
RPTC (7-0) {| An 8-bit counter to control the repeated execution of a single instruction. 


Shifters SFL, SFR . Shifters SFL (left) and SFR (right) are located at the ALU input, the accu- 
mulator output, and the product register output. Also an in-place shifter within 
the accumulator. 


TIM (15-0) A 16-bit memory-mapped timer (counter) for timing control. 


Accumulator ACC (31-0) A 32-bit accumulator split in two halves: ACCH (accumulator high) and 
ACCH(31-16)} ACCL (accumulator low). Used for storage of ALU output. 
ACCL(15-0) 

Auxiliary Register File ARO,AR1,AR2| A register file containing 8 16-bit auxiliary registers (ARO-AR7), used for 
AR3,AR4,AR5| addressing data memory, for temporary storage, or for integer arithmetic 



















A 16-bit counter used to prefetch program instructions. The PFC contains the 
address of the instruction currently being prefetched. The PFC is updated 
when a new prefetch is initiated. The PFC is also used to address data memory 




















processing through the ARAU. 


Auxiliary Register Pointer | ARP(2-0) A 3-bit register used to select one of the eight auxiliary registers. 
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Table 3-1. Internal Hardware (Continued) 


UNIT SYMBOL FUNCTION 


REGISTERS 


ARB(2- 0) A 3-bit register used to buffer the ARP. Each time the ARP is loaded, the old 
value is written to the ARB, except during an LST (load status register) 





Auxiliary oe Pointer 
Buffer 








instruction. When the ARB is loaded with an LST1, the same value is also 
copied into ARP. 


A 9-bit register pointing to the address of the current page. Data pages are 
128 words each, resulting in 512 pages of addressable data memory space 
(some locations are reserved). 


Global Memory GREG(7-0) | An 8-bit memory-mapped register for allocating the size of the global 
Allocation Register memory space. 
Instruction Register IR(15-0) A 16-bit register used to store the currently executing 
instruction. 
QIR(15-0) A 16-bit register used to store prefetched instructions. 
Register 


Interrupt Flag Register IFR(5-0) A 6-bit flag register used to latch the active-low external user interrupts 
INT(2-0) and the internal interrupts XINT/RINT (serial port transmit/receive 
interrupts) and TINT (timer interrupt). The IFR is not accessible through 
software. 








Data Memory Page 
Pointer 





DP(8-0) 










Interrupt Mask Register IMR(5-0) A 6-bit memory-mapped register used to mask interrupts. 


Product Register PR(31-0) A 32-bit product register used to hold the multiplier product. The PR 


PH(31-16) can also be accessed as the most or least significant words using the SPH 
PL(15-0) (store P register high) or SPL (store P register low) instructions. 


Stack Stack(15-0) | An8 x 16 hardware stack used to store the PC during interrupts or calls. The 
ACCL and data memory values, may also be pushed onto and popped from the 
stack. 


MicroCall Stack MCS (15-0) } A single-word stack that temporarily stores the contents of the PFC while the 

: PFC is being used to address data memory with the block move (BLKD and 
BLKP), multiply/accumulate (MAC and MACD), and table read/write (TBLR 
and TBLW) instructions. 


Serial Port Data DRR(15-0) | A 16-bit memory-mapped serial port data receive register. Only the eight 
Receive Register | LSBs are used in the byte mode. 

Serial Port Data DXR(15-0) A 16-bit memory-mapped serial port data transmit register. Only the eight 
Transmit Register LSBs are used in the byte mode. 


Serial Port Receive RSR(15-0) A 16-bit register used to shift in serial port data from the RX pin. RSR contents 
Shift Register are sent to the DRR after a serial transfer is completed. RSR is not directly 
accessible through software. 



















Serial Port Transmit XSR(15-0) 
Shift Register 


A 16-bit register used to shift out serial port data onto the DX pin. XSR contents 
are loaded from DXR at the beginning of a serial port transmit operation. XSR 
is not directly accessible through software. 


Status Registers STO,ST1 Two 16-bit status registers that contain status and control bits. 
(15-0) 
Temporary Register TR(15-0) A 16-bit register that holds either an operand for the multiplier or a shift code 
for the scaling shifter. | 
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Table 3-1. Internal Hardware (Concluded) 


Data Memory Address DAB(15-0) A 16-bit bus that carries the data memory address. 
Bus 


Direct Data Memory DRB(15-0) A 16-bit bus that carries the ‘direct’ address for the data memory, which is the 
Address Bus concatenation of the DP register with the seven LSBs of the instruction. 


Program Bus P(15-0) A 16-bit bus used to route instructions (and data for the MAC and MACD 
instructions). 

Program Memory Address| PAB(15-0) A 16-bit bus that carries the program memory address. 

Bus 















3.2 Memory Organization 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM and 
4K words of maskable program ROM. Of the 544 words of on-chip data RAM, 288 
are always data memory and the remaining 256 words may be configured as either 
program or data memory. This section explains memory management using the 
on-chip program ROM and data RAM, external memory, memory maps, memory- 
mapped registers, auxiliary registers, data memory addressing, and memory-to-me- 
mory moves. 


3.2.1 On-Chip Program ROM 


The 4K words of on-chip program ROM allow program execution at full speed 
without the need for high-speed external program memory. The use of this memory 
also allows the external data bus to be freed for access of external data memory. In 
addition, there is the added benefit of increased security for the algorithms contained 
in on-chip memory, which may be proprietary. 


Mapping of the first 4K-word block of program memory is user-selectable by means 
of the MP/MC (microprocessor/microcomputer) pin. Setting MP/MC high maps in 
the block of off-chip memory while holding the pin low maps in the block of on-chip 
ROM. The XF (external flag) pin can be used to toggle the MP/MC pin to dynamically 
enable or disable the on-chip ROM. The MP/MC pin is in the location of a VCC pin 
on the TMS32020. This allows substitution of a TMS320C25 for a TMS32020 since 
the TMS320C25 automatically operates in the microprocessor mode and therefore 
is directly compatible in the system. See Section 3.2.3 for the location of the on-chip 
program ROM in the memory map configurations. 
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3.2.2 On-Chip Data RAM Blocks | 
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The 544 words of on-chip data RAM are divided into three separate blocks (BO, B1, 
and B2), as shown in Figure 3-2. Of the 544 words, 256 words (block BO) are 
configurable as either data or program memory by instructions provided for that 
purpose; 288 words (blocks B1 and B2) are always data memory. A data memory 
size of 544 words allows the TMS320C25 to handle a data array of 512 words (256 
words if on-chip RAM is used for program memory), while still leaving 32 locations 
for intermediate storage. See Section 3.2.3 for memory map configurations. 


When using block BO as program memory, instructions can be downloaded from 
external program memory using the RPTK (repeat instruction as specified by imme- 
diate value) and BLKP (block move from program memory to data memory) 
instructions. | : | 
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Figure 3-2. On-Chip Data Memory 


When using on-chip program RAM, ROM, or high-speed external program memory, 
the TMS320C25 runs at full speed without wait states. However, the READY line 
can be used to interface the TMS320C25 to slower, less-expensive external memory. 
Downloading programs from slow off-chip memory to on-chip program RAM speeds 
processing while cutting system costs. See Section 3.5 for a description of instruction 
execution using various memory configurations. 
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3.2.3 Memory Maps 


The TMS320C25 provides three separate address spaces for program memory, data 
memory, and I/O, as shown in Figure 3-3. These spaces are distinguished externally 
by means of the PS, DS, and IS (program, data, and |/O space select) signals. The 
on-chip memory blocks BO, B1, and B2 are comprised of a total of 544 words of 
RAM. Program/data RAM block BO (256 words) resides in pages 4 and 5 of the data 
memory map when configured as data RAM and at addresses >FFOO to >FFFF when 
configured as program RAM. Block B1 (always data RAM) resides in pages 6 and 
7, while block B2 resides in the upper 32 words of page 0. Note that the remainder 
of page 0 is composed of the memory-mapped registers and reserved locations, and 
pages 1-3 of the data memory map consist of reserved locations. Reserved locations 
may not be used for storage, and their contents are undefined when read. See Section 
3.2.4 for further information on the memory-mapped registers. 


The CNFD/CNFP instructions are used to configure block BO as either data or 
program memory, respectively. The BLKP (block move from program memory to data 
memory) instruction may be used to download program information to block BO 
when it is configured as data RAM, and then a CNFP (configure block as program 
memory) instruction may be used to convert it to program RAM (see the code 
example in Section 5.4.2). 


Reset configures block BO as data RAM. Note that, due to internal pipelining, when 
the CNFD or CNFP instruction is used to remap RAM block BO, there is a delay before 
the new configuration becomes effective. This delay is one fetch cycle if execution 
is from internal program RAM and two fetch cycles if execution is from ROM or 
external program memory. This is particularly important if program execution is from 
the locations around 65280. Accordingly, a CNFP instruction must be placed at 
location 65277 in external memory if execution is to continue from the first location 
in block BO. 


If a CNFP is placed at location 65278, and the instruction at location 65279 is a 
two-word instruction, the second word of the instruction will be fetched from the 
first location in block BO. If execution is from above location 65280 and block BO 
is reconfigured, care must be taken to assure that execution resumes at the appro- 
priate point in a new configuration. See Section 3.4.1 for a detailed description of 
pipeline operation. 


On-chip program ROM is located in the lower 4K words of program memory when 
selected by setting MP/MC = 0. When MP/MC = 1, the lower 4K words of program 
memory are external. 
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Figure 3-3. Memory Maps 
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3.2.4 Memory-Mapped Registers 


The six registers mapped into the data memory space are listed in Table 3-2 and are 
shown in the block diagram of Figure 3-1. 


The memory-mapped registers may be accessed in the same manner as any other 
data memory location, with the exception that block moves using the BLKD (block 
move from data memory to data memory) instruction cannot be performed from the 
memory-mapped registers. 


Table 3-2. Memory-Mapped Registers 


REGISTER ADDRESS 
NAME LOCATION DEFINITION 


DRR(15-0) Serial port data receive register 
DXR(15-0) Serial port data transmit register 







— © 
















TIM (15-0) Timer register 
PRD(15-0) Period register 
IMR (5-0) Interrupt mask register 


GREG(7-0) Global memory allocation register 


3.2.5 Auxiliary Registers 


The TMS320C25 provides a register file containing eight auxiliary registers (ARO- 
AR7). This section discusses each register’s function and how an auxiliary register 
is selected and stored. 


The auxiliary registers may be used for indirect addressing of data memory or for 
temporary data storage. Indirect auxiliary register addressing (see Figure 3-4) allows 
placement of the data memory address of an instruction operand into one of eight 
auxiliary registers. These registers are pointed to by a three-bit Auxiliary Register 
Pointer (ARP) that is loaded with a value from 0 through 7, designating ARO through 
AR7, respectively. The auxiliary registers and the ARP may be loaded either from 
data memory or by an immediate operand defined in the instruction. The contents 
of these registers may also be stored in data memory. (Section 4 describes the 
programming of the indirect addressing mode.) 
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Figure 3-4. Indirect Auxiliary Register Addressing Example 


The auxiliary register file (ARO-AR7) is connected to the Auxiliary Register Arithmetic 
Unit (ARAU), shown in Figure 3-5. The ARAU may autoindex the current auxiliary 


register while the data memory location is being addressed. Indexing by either +1 


or by the contents of ARO may be performed. As a result, accessing tables of infor- 
mation does not require the Central Arithmetic Logic Unit (CALU) for address 
manipulation, thus freeing it for other operations. | 
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Figure 3-5. Auxiliary Register File 


As shown in Figure 3-5, auxiliary register O (ARO) or the eight LSBs of the instruction 
registers can be connected to one of the inputs of the ARAU. The other input is fed 
by the current AR (being pointed to by ARP). AR(ARP) refers to the contents of the 
current AR pointed to by ARP. The ARAU performs the following functions: 


AR(ARP) + ARO ~ AR(ARP) _ Index the current AR by adding a 16-bit integer 
contained in ARO. 
AR(ARP) - ARO ~ AR(ARP) _ Index the current AR by subtracting a 16-bit 
integer contained in ARO. | 
AR(ARP) Increment the current AR by one. 


J 


AR(ARP) + 1 


AR(ARP) - 1 > AR(ARP) Decrement the current AR by one. 

AR(ARP) > AR(ARP) AR(ARP) is unchanged. 

AR(ARP) + IR(7-0) ~ AR(ARP) Add 8-bit immediate value to the current 
AR. 

AR(ARP) -  IR(7-0) ~ AR(ARP) Subtract 8-bit immediate value to the 
current AR. 


AR(ARP) + rcARO ~~ AR(ARP) _ Bit-reversed indexing with reverse-carry 
propagation (see Section 4.1.2). 

rcARO ~~ AR(ARP) _ Bit-reversed indexing with reverse-carry 
propagation (see Section 4.1.2). 


AR(ARP) 


Although the ARAU is useful for address manipulation in parallel with other oper- 
ations, it may also serve as an additional general-purpose arithmetic unit since the 
auxiliary register file can directly communicate with data memory. The ARAU 
implements 16-bit unsigned arithmetic, whereas the CALU implements 32-bit 
two’s-complement arithmetic. Instructions provide branches dependent on the 
comparison of the auxiliary register pointed to by ARP with ARO. 


Figure 3-5 also shows the three-bit Auxiliary Register pointer Buffer (ARB) that 
provides storage for the ARP on subroutine calls and interrupts. 
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3. 2.6 Addressing Modes 


The TMS320C25 can address a total Pr 64K weds of program memory and 64K 
words of data memory. The on-chip data memory is mapped into the 64K data 
memory space. The memory maps, which change with the configuration of block © 
BO, are described in detail in Section 3.2.4. | 


The 16-bit Data Address Bus (DAB) addresses data memory in one of the following 


two ways: 


1) By the DiRect address Bus (DRB) using the direct addressing mode (e.g., ADD 
>10), or 


2) By the Auxillary register File Bus (AFB) using the indirect saceomne mode 
(e.g., ADD *). | 


Operands are also addressed by the contents of the program counter in the immediate 
addressing mode. 


Figure 3-6 illustrates operand addressing in the direct, indirect, and immediate 
addressing: modes. | 


INSTRUCTION 
DIRECT ADDRESSING [OPCODE| dma | DP 





INDIRECT ADDRESSING 


INSTRUCTION | | 
IMMEDIATE OPERAND | OPCODE JOPERAND PC INSTRUCTION 


PC+4 OPERAND 


Figure 3-6. Methods of Instruction Operand Addressing 


If the direct addressing mode is used, the 9-bit Data memory page Pointer (DP) 
points to one of 512 128-word pages. The data memory address (dma), specified 
by the seven LSBs of the instruction, points to the desired word within the page. 
The address on the direct address bus (DRB) is formed by concatenating the 9-bit 
DP with the 7-bit dma. 


When using the indirect addressing mode, the currently selected 16-bit auxiliary 
register AR(ARP) addresses the data memory through the auxiliary register file bus 
(AFB). While the selected auxiliary register provides the data memory address and 
the data is being manipulated by the Central Arithmetic Logic Unit (CALU), the 
contents of the auxiliary register may be manipulated through the Auxiliary Register 
Arithmetic Unit (ARAU). See Figure 3-4 for an example of indirect auxiliary register 
addressing. The direct and indirect addressing modes are described in detail in 
Section 4.1. 


When an immediate operand is used, it is either contained within the instruction word 
itself or, in the case of 16-bit immediate operands, the word following the instruction 
opcode. | 
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3.2.7 Memory-to-Memory Moves 


The TMS320C25 provides instructions for data and program block moves and for 
data move functions that efficiently utilize the configurable on-chip RAM. 


The BLKD instruction moves a block within data memory, and the BLKP instruction 
moves a block from program memory to data memory. When used with the repeat 
instructions (RPT and RPTK), the BLKD and BLKP instructions efficiently perform 
block moves from on- or off-chip memory. 


The DMOV (data move) function is useful for implementing algorithms that use the 
z-1 delay operation, such as convolutions and digital filtering where data is being 
passed through a time window. The data move function can be used anywhere 
within blocks BO, B1, or B2. It is continuous across the boundary of blocks BO and 
B1 but cannot be used with off-chip data memory. 


Implemented in on-chip RAM, the DMOV function is equivalent to that of the 
TMS32010 and TMS32020. DMOV allows a word to be copied from the currently 
addressed data memory location in on-chip RAM to the next higher location while 
the data from the addressed location is being operated upon in the same cycle (e.g., 
by the CALU). An ARAU operation may also be performed in the same cycle when 
using the indirect addressing mode. The MACD (multiply and accumulate with data 
move) and the LTD (load T register, accumulate previous product, and move data) 
instructions use the data move function. 


3.3 Central Arithmetic Logic Unit (CALU) 


The TMS320C25 Central Arithmetic Logic Unit (CALU) contains a 16-bit scaling 
shifter, a 16 x 16-bit parallel multiplier, a 32-bit Arithmetic Logic Unit (ALU), a 32-bit 
accumulator (ACC), and additional shifters at the outputs of both the accumulator 
and the multiplier. This section describes the CALU components and their functions. 
Figure 3-7 is a block diagram showing the components of the CALU. 


The following steps occur in the implementation of a typical ALU instruction: 
1) Data ts fetched from the RAM on the data bus, 


2) Data is passed through the scaling shifter and the ALU where the arithmetic is 
performed, and 


3) The result is moved into the accumulator. 


One input to the ALU is always provided from the accumulator, and the other tnput 
may be fed from the Product Register (PR) of the multiplier or the scaling shifter that 
is loaded from data memory. 


Device Operation | 


SCALING 
SHIFTER 


AD 


ee ACCH(16 mets, 
16 


SEL(O-7 





Figure 3-7. Central Arithmetic Logic Unit (CALU) 


3.3.1 Scaling Shifter 
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The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 
32-bit output connected to the ALU (see Figure 3-7). The scaling shifter produces 
a left shift of O to 16 bits on the input data, as programmed in the instruction. The 
LSBs of the output are filled with zeros, and the MSBs may be either filled with zeros 
or sign-extended, depending upon the status programmed into the SXM (sign-ex- 
tension mode) bit of status register STO. 


The TMS320C25 also contains several other shifters, which allow it to perform 
numerical scaling, bit extraction, extended arithmetic, and overflow prevention. These 
shifters are connected to the output of the multiplier and the accumulator. 
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3.3.2 ALU and Accumulator 


The TMS320C25 32-bit ALU and accumulator implement a wide range of arithmetic 
and logical functions, the majority of which execute in a single clock cycle. Once 
an operation is performed in the ALU, the result is transferred to the accumulator 
where additional operations such as shifting may occur. Data that is input to the 
ALU may be scaled by the scaling shifter. 


The 32-bit accumulator (see Figure 3-7) is split into two 16-bit segments for storage 
in data memory: ACCH (accumulator high) and ACCL (accumulator low). Shifters 
at the output of the accumulator provide a left-shift of 0 to 7 places. This shift is 
performed while the data is being transferred to the data bus for storage. The contents 
of the accumulator remain unchanged. When the ACCH data is shifted left, the LSBs 
are transferred from the ACCL, and the MSBs are lost. When ACCL is shifted left, 
the LSBs are zero-filled, and the MSBs are lost. 


The accumulator also has an associated carry bit that is set or reset depending on 
various operations within the TMS320C25. The carry bit allows more efficient 
computation of extended-precision products and additions or subtractions. It is 
affected by most arithmetic instructions as well as the shift and rotate instructions. 
It is not affected by loading the accumulator, logical operations, or other such 
nonarithmetic or control instructions. It is also not affected by the multiply (MPY, 
MPYK, and MPYU) instructions, but is affected by the accumulation process in the 
MAC and MACD instructions. Examples of carry bit operation are shown in Figure 


3-8. 

C MSB LSB C MSB LSB 

X FFFF Bee nee X 0000 0000 ACC 
1 | = 1 
10000 0000 O FFFF FFFF 

X 7FFF FFFF ACC X 8000 0000 ACC 
+ TS (OVM=0) - __———sA SS (OVM=0) 
0 8000 0000 1 7VFFF FFFF 
10000 0000 Acc O FFFF FFFFE ACC 


+ Q (ADDC oe Q (SUBB 
0 0000 000 1 INSTRUCTION) 1 FRFFF FF F E INSTRUCTION) 


Figure 3-8. Examples of Carry Bit Operation 


The value added to or subtracted from the accumulator, shown in the examples of 
Figure 3-8, may come from either the input scaling shifter or the shifter at the output 
of the P register. The carry bit is set tf the result of an addition or accumulation process 
generates a carry, or reset to zero if the result of a subtraction generates a borrow. 
Otherwise, it is reset after an addition or set after a subtraction. 


The ADDC (add to accumulator with carry) and SUBB (subtract from accumulator 
with borrow) instructions use the previous value of carry in their addition/subtraction 
Operation (see these instructions in Section 4 for more detailed information). 


The one exception to operation of the carry bit, as shown in Figure 3-8, is in the use 
of the ADDH (add to high accumulator) and SUBH (subtract from high accumulator) 
instructions. The ADDH instruction can only set the carry bit if a carry is generated, 
and the SUBH instruction can only reset the carry bit if a borrow is generated; 
otherwise, neither instruction can affect it. . 
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Two branch instructions, BC and BNC, have been provided for branching on the 
status of the carry bit. The SC, RC, and LST1 instructions can also be used to load 
the carry bit. The carry bit is set to one on a hardware reset. 


The SFL and SFR (in-place one-bit shift to the left or right) and ROL and ROR (rotate 
to the left or right) instructions implement shifting or rotating of the contents of the 
accumulator through the carry bit. The SXM bit affects the definition of the SFR (shift 
accumulator right) instruction. When SXM = 1, SFR performs an arithmetic right 
shift, maintaining the sign of the accumulator data. When SXM = 0, SFR performs 
a logical shift, shifting out the LSB and shifting in a zero for the MSB. The SFL (shift 
accumulator left) instruction is not affected by the SXM bit and behaves the same 
in both cases, shifting out the MSB and shifting in a zero. Repeat (RPT or RPTK) 
instructions may be used with the shift and rotate instructions for multiple shift 
counts. . 


The TMS320C25 supports floating-point operations for applications requiring a large 
dynamic range. The NORM (normalization) instruction is used to normalize fixed- 
point numbers contained in the accumulator by performing left shifts. The LACT 
(load accumulator with shift specified by the T register) instruction denormalizes a 
floating-point number by arithmetically left-shifting the mantissa through the input 
scaling shifter. The shift count, in this case, is the value of the exponent specified 
by the four low-order bits of the T register (TR). ADDT and SUBT (add to/subtract 
from accumulator with shift specified by T register) instructions have also been 
provided to allow additional arithmetic operations. Floating-point numbers with 
16-bit mantissas and 4-bit exponents can thus be manipulated. 


The accumulator overflow saturation mode may be programmed through the SOVM 
and ROVM (set/reset overflow mode) instructions. When the accumulator is in the 
overflow saturation mode and an overflow occurs, the overflow flag is set and the 
accumulator is loaded with the most positive or negative number depending upon 
the direction of overflow. 


The TMS320C25 also has the capacity of executing branch instructions that depend 
on the status of the ALU and accumulator. These instructions include the BC (branch 
on carry), BV (branch on overflow), and BZ (branch on accumulator equal to zero) 
instructions. (Refer to Section 4 for a complete list of TMS320C25 instructions.) In 
addition, the BACC (branch to address in accumulator) instruction provides the 
ability to branch to an address specified by the accumulator. _ 


3.3.3 Multiplier, T and P Registers 
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The TMS320C25 utilizes a 16 x 16-bit hardware multiplier, which is capable of 
computing a 32-bit product in a single machine cycle. As shown in Figure 3-7, the 
following two registers are associated with the multiplier: 


@ A 16-bit Temporary Register (TR) that holds one of the operands for the 
multiplier, and 


@ <A 32-bit Product Register (PR) that holds the product. 


Normally, an LT (load T register) instruction loads the TR to provide one operand 
(from the data bus), and the MPY (multiply) instruction provides the second operand 
(also from the data bus). Alternatively, a multiplication can be performed with an 
immediate operand using the MPYK instruction. In either case, a product can be 
obtained every two cycles. | 


Two multiply/accumulate instructions (MAC and MACD) fully utilize the computa- 
tional bandwidth of the multiplier, allowing both operands to be processed simul- 
taneously. For MAC and MACD, two operands are transferred to the multiplier each 
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cycle via the program and data buses. This’ provides for  single-cycle 
multiply/accumulates when used with repeat (RPT or RPTK) instructions. The MAC 
and MACD instructions can be used with operands in either internal or external 
memory. The SQRA (square/add) and SQRS (square/subtract) instructions pass the 
same value to both inputs of the multiplier for squaring a data memory value. 


All multiply instructions, except the MPYU (multiply unsigned) instruction, perform 
a signed multiply operation in the multiplier. That is, the two numbers being multi- 
plied are treated as two’s-complement numbers, and the result is a 32-bit two’s- 
complement number. The MPYU instruction performs an unsigned multiplication, 
which greatly facilitates multiple-precision arithmetic operations. This allows oper- 
ands of greater than 16 bits to be broken down into 16-bit words and processed 
separately to generate products of greater than 32 bits. 


After the multiplication of two 16-bit numbers, the 32-bit product is loaded into the 
32-bit Product Register (PR). The product from the PR may be transferred to the 
ALU directly or optionally shifted before it is transferred to the ALU. 


Four product shift modes (PM) are available. The PM field of status register ST1 
specifies the PM shift mode, as shown in Table 3-3. 


Table 3-3. PM Shift Modes 


LV IFPMis: | RESULT 


No shift’ 


Left shift of 1 bit 
Left shift of 4 bits 
Right shift of 6 bits 





Left shifts specified by the PM value are useful for implementing fractional arithmetic 
or justifying fractional products. For example, the product of either two normalized, 
16-bit, two’s-complement numbers or two Q15 numbers contains two sign bits, one 
of which is redundant (see Section 5.6.6 for an explanation of 015 representation). 
The single-bit left shift allows this extra sign bit to be shifted off of the product when 
it is passed to the accumulator. This results in the accumulator contents being 
formatted in the same manner as the multiplicands. Similarly, the product of either 
a normalized, 16-bit, two’s-complement or Q15 number and a 13-bit, two’s- 
complement constant contains five sign bits, four of which are redundant. This is 
the case, for example, when using the MPYK instruction. Here the four-bit shift 
properly aligns the result as it is transferred to the accumulator. 


Use of the right-shift PM value allows the execution of up to 128 consecutive 
multiply/accumulate operations without the threat of an arithmetic overflow, thereby 
avoiding the overhead of overflow management. The shifter can be disabled to cause 
no shift in the product when working with integer or 32-bit precision operations. 
This allows compatibility with TMS32010 code to be maintained. Note that the PM 
right shift is always sign-extended regardless of the state of SXM. 


The four least significant bits of the T register (TR) also define a variable shift through 
the scaling shifter for the LACT/ADDT/SUBT (load/add-to/subtract-from accu- 
mulator with shift specified by the TR) instructions. These instructions are useful in 
floating-point arithmetic where a number needs to be denormalized, t.e., floating- 
point to fixed-point conversion. The BITT (bit test) instruction allows testing of a 
single bit of a word in data memory based on the value contained in the four LSBs 
of the TR. 
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3.4 System Control 


System control on the TMS320C25 is provided by the program counter and related 
hardware, the external reset signal, the status registers, the on-chip timer, and the 
repeat counter. The following sections describe the function of each of these 
components in system control. 


3.4.1 Program Counter and Related Hardware 
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The description of the TMS320C25 Program Counter (PC) and its related hardware 
contained in this section provides information useful in understanding the sequence 
of external bus operations that occurs during instruction execution. It should be 
noted, however, that in virtually all cases, operation of this hardware and its effects 
on operation of the internal pipeline are transparent to the user and are included in 
the instruction cycle timings provided in Appendix E. 


The PC and related hardware (see Figure 3-9) direct program execution on the 
TMS320C25. Included in the related hardware are the eight-level PC stack, the 
Prefetch Counter (PFC), the 16-bit MicroCall Stack (MCS) register, the Instruction 
Register (IR), and the Queue Instruction Register (QIR). The operation of these 
components and their function in instruction pipelining is now described in detail. 


TO PROGRAM 
ADDRESS BUS 


(8 x _ 16) 





Figure 3-9. Program Counter and Related Hardware 


In order to speed instruction execution, the TMS320C25 utilizes a three-level internal 
pipeline, which divides an instruction cycle into three operations: prefetch, decode, 
and execution. The PFC contains the address of the next instruction to be prefetched. 
Once an instruction is prefetched, the instruction is loaded into the IR, unless the IR 
still contains an instruction currently executing, in which case the prefetched 
instruction is stored in the QIR. The PFC is then incremented, and after the current 
instruction has completed execution, the instruction in the QIR is loaded into the IR 
to be executed. | 
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The PC contains the address of the next instruction to be executed, and is not used 
directly in instruction fetch operations, but merely serves as a reference pointer to the 
current position within the program. The PC is incremented as each instruction ts 
executed. When interrupts or subroutine call instructions occur, the contents of the 
PC are pushed onto the stack to preserve return linkage to the previous program 
context. 


In the operation of the pipeline, the prefetch, decode, and execute operations are 
independent, which allows instruction executions to overlap. Thus, during any given 
cycle, three different instructions can be active, each at a different stage of 
completion, resulting in the three-instruction pipeline. Figure 3-10 shows the 
operation of the three-level pipeline for single-word, single-cycle instructions 
executing from either internal program ROM or external memory with no wait states. 


CLKOUT1 | | | | | | | 


decode ¢——N-l___44__N__,,4__Nel__,,__ 
execute qe? gg gg Ng g — 


Figure 3-10. Three-Level Pipeline Operation 


Pipelining is reduced to two levels when execution is from internal program RAM 
due to the fact that an instruction in internal RAM can be fetched and decoded in 
the same cycle. Thus, separate prefetch and decode operations are not required, as 
shown in Figure 3-11. 


CLKOUT1 | | | | | | | 


decode Ng NN 
execute Nig NN 


Figure 3-11. Two-Level Pipeline Operation 


Note that the difference in pipeline levels does not necessarily affect instruction 
execution speed, but merely changes the fetch/decode sequence. Most instructions 
execute in the same number of cycles regardless of whether they are executed from 
internal RAM, ROM, or external program memory. Also note that the effects of 
pipelining are included in the instruction cycle timings listed in Appendix E. 


When branches, subroutine calls, or interrupts occur, the pipeline flow shown in 
Figure 3-12 and Figure 3-13 is disrupted because the pipeline prefetches sequen- 
tially, and cannot in general detect that a transfer of control will occur until an 
instruction reaches execution. This is especially true with conditional branches. 


Device Operation 


Bing branch or call instructions, both the PC and PFC are loaded with the desti- 


- nation address, and the pipeline must be refilled. This causes these instructions to 


require at least three cycles to execute when the destination address is located 


externally or in internal program ROM. When the destination address is located in 
internal program RAM, branch instructions generally execute in two cycles, due to 


the two-level pipeline for internal RAM. In either case, some instructions that have 


been prefetched may be discarded. as control passes to the branch destination 


address. Operation of the pipeline during interrupts is similar and is described in 
Section 3.6.2. 


Operation of the pipeline during execution of a conditional branch instruction such 
as a BANZ (branch on auxiliary register not zero), located in external program 
memory with no wait states, is shown in Figure 3-12. The diagram shows the 
sequence that occurs when the branch is taken, and the destination address is also 
in external memory. When the branch is not taken, instruction execution continues 
sequentially, and the branch instruction requires only two cycles to execute. Oper- 
ation of unconditional branches is identical to that of conditional branches with the 
exception that in conditional branches, the N+2 instruction is not fetched, although 
the address bus is still driven with N+2. 


CLKOUT1 | | | | | | | | | | | | | | | 


N+1 N+2 DEST DEST + 1 DEST + 2 


A15-A0 «N14 _Net__p4-__Me2_,g _DEST_gq_DEST + 1_y4 DEST #2 


prefetch - : 


decode : 





execute ig —_N2 ig Hed gig Nig NN gg Ng DT 
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Figure 3-12. Pipeline Operation During BANZ Instruction 


There is one additional condition under which the pipeline becomes disrupted. This 
is when execution of single-cycle instructions changes from internal RAM to external 
program memory or internal ROM. This occurs in only the following two cases: 


1) When execution of single-cycle instructions wraps around from >FFFF in block 
BO (when configured as program memory) to location >QQ0O0. 


2) When execution of single-cycle instructions is from block BO (configured as 
program memory) and a CNFD instruction is executed, converting block BO to 
data memory. 


Under these conditions, one dummy execute cycle occurs as the pipeline is refilled. 
This situation is depicted in Figure 3-13. Note that this condition occurs only under 
the above circumstances, and its effects | are not included in the instruction cycle 
timings given in Appendix E. 
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prefetch 


decode 


execute 





Legend: Pl = Program Internal 
PE = Program External 
PR = Program ROM 


Figure 3-13. Pipeline Operation When Crossing Program Boundaries 


3.4.2 Reset 


The contents of the accumulator may be loaded into the PC and PFC in order to 
implement “computed go to” operations. This can be accomplished using the BACC 
(branch to address in accumulator) or CALA (call subroutine indirect) instructions. 


The PC stack is accessible through the use of the PUSH and POP instructions. 
Whenever the contents of the PC are pushed onto the top of the stack, the previous 
contents of each level are pushed down, and the eighth location of the stack is lost. 
Therefore, data will be lost if more than eight successive pushes occur before a pop. 
The reverse happens on pop operations. Any pop after seven sequential pops yields 
the value at the eighth stack level. All eight stack levels then contain the same value. 
Two additional instructions, PSHD and POPD, push a data memory value onto the 
stack or pop a value from the stack to data memory. These instructions allow a stack 
to be built in data memory for the nesting of subroutines/interrupts beyond eight 
levels. 


The 16-bit MicroCall Stack (MCS) register is used expressly for temporary storage 
of the PFC contents during execution of the TBLR/TBLW, MAC/MACD, and 
BLKD/BLKP instructions. In these instructions, two operand addresses are required: 
one provided through either direct or indirect addressing, and the other loaded into 
the PFC. When execution of the instruction is completed, the contents of the MCS 
are transferred back to the PFC. 


Reset (RS) is a non-maskable external interrupt that can be used at any time to put 
the TMS320C25 into a known state. Reset is typically applied after powerup when 
the machine is in a random state. 


Driving the RS signal low causes the TMS320C25 to terminate execution and forces 
the program counter to zero. RS affects various registers and status bits. At powerup, 
the state of the processor is undefined. For correct system operation after powerup, 
a reset signal must be asserted low for at least three clock cycles to guarantee a reset 
of the device. Processor execution begins at location 0, which normally contains a 
B (branch) statement to direct program execution to the system initialization routine 
(see Section 5.1 for an initialization routine example). 


Upon receiving an RS signal, the following actions take place: 
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1) A logic 0 is loaded into the CNF (configuration control) bit in Status registae 


ST1, causing all RAM to be configured as data memory. 


2). The Program Counter r (PC) is set to 0, and the address bus A15-A0 is driven 
with all zeroes while RS is low. 


3) The data bus D15-D0 is placed in the high-impedance state.. 


4) All memory and |/O space control signals (PS, DS, IS, R/W, STRB, and BR) are 
de-asserted by setting them to high levels while RS is low. 


5) All interrupts are disabled by setting the INTM (interrupt mode) bit to a high 


level. (Note that RS is non- Oeeserrer The interrupt flag register (IFR) is reset 
to all zeroes. 


6) Status bits: — | | | | 
0 > OV; 1 ~ XF; 1 ~ SXM; 0 > PM; 1 ~ HM; 0 > FO;1 7 C 
1 > FSM (Remaining status bits are unchanged). 


7) The global memory allocation register (GREG) is cleared to make all memory 
local. | 


8) The RPTC (repeat counter) is cleared. 


9) The DX (data transmit) pin is placed in the high-impedance state. Any 
| transmit/receive operations on the serial port are terminated, and the TXM 
(transmit mode) bit is reset to a low level. This configures the FSX framing pulse 

to be an input.. A transmit/receive operation may be started by framing pulses © 
only after the removal of RS. 


10) The timer (TIM) and period (PRD) + registers are both set to >FFFF and TIM 
‘does not begin decrementing until RS is de-asserted. 


11) The IACK (interrupt PERDOWIEAgS) signal is generated in the same manner as a 
maskable interrupt. | 


Execution starts from location 0 of program memory when the RS signal is taken high. 
Note that if RS is asserted while in the hold mode, normal reset operation occurs 
internally, but all buses and control lines remain in the high-impedance state. Upon 
release of HOLD and RS, execution starts from location zero. 





Note that the ARB, ARP, DP, IMR, OVM, and TC bits are not initialized by reset. 


3.4.3 Status Registers 
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Two status registers, STO and ST1, contain the status of various conditions and 
modes. The SST and SST1 instructions provide for storing the status registers into 
data memory. The LST and LST1 instructions load the status registers from data 
memory. In this manner, the current status of the device may be saved on interrupts 
and subroutine calls. | 


Figure 3-14 shows the organization of both status registers, indicating all status bits 
contained in each. Note that the DP, ARP, and ARB registers are shown as separate 
registers in the processor block diagram of Figure 3-1. Because these registers do 
not have separate instructions for storing them into RAM, they are included in the 
status registers. 
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Figure 3-14. Status Register Organization 


The capability of storing the status registers into data memory and loading them from 
data memory allows the status of the machine to be saved and restored for interrupts 
and subroutines. All status bits are written to and read from using LST/LST1 and 
SST/SST1 instructions, respectively (with the exception of INTM, which cannot be 
loaded via an LST instruction). However, some additional instructions or functions 
may affect those bits, as indicated in Table 3-4. 


As shown in Figure 3-14, several bits in the status registers are reserved and are read 
as logic ‘1’s by the LST and LST1 instructions. 


Table 3-4. Status Register Field Definitions 


FIELD FUNCTION 


Auxiliary Register Pointer Buffer. Whenever the ARP is loaded, the old ARP value is copied to the ARB 
except during an LST instruction. When the ARB is loaded via an LST1 instruction, the same value is also 
copied to the ARP. 


Auxiliary Register Pointer. This three-bit field selects the AR to be used in indirect addressing. When ARP 
is loaded, the old ARP value is copied to the ARB register. ARP may be modified by memory-reference 
instructions when using indirect addressing, and by the LARP, MAR, and LST instructions. ARP is also 
loaded with the same value as ARB when an LST1 instruction is executed. 


Carry bit. This bit is set to ‘1’ if the result of an addition generates a carry, or reset to ‘0’ if the result of a 
subtraction generates a borrow. Otherwise, it is reset after an addition or set after a subtraction, except if 
the instruction is an ADDH or a SUBH. ADDH can only set and SUBH only reset the carry bit, but cannot 
affect it otherwise. The shift and rotate instructions also affect this bit, as well as the SC, RC, and LST1 
instructions. Two branch instructions, BC and BNC, have been provided to branch on the status of C. C 
is set to ‘1’ on a reset. The carry bit is useful in implementing multiple-precision arithmetic and in overflow 
management. 


On-Chip RAM Configuration Control bit. If set to ‘0’, block BO is configured as data memory; otherwise, 
block BO is configured as program memory. The CNF may be modified by the CNFD, CNFP, and LST1 
instructions. RS resets the CNF to ’0’. 


Data Memory Page Pointer. The 9-bit DP register is concatenated with the 7 LSBs of an instruction word 
to form a direct memory address of 16 bits. DP may be modified by the LST, LDP, and LDPK instructions. 


Format bit. A ‘0’ configures the serial port registers as 16-bit registers. A ‘1’ configures the port registers to 
receive and transmit eight-bit bytes. FO may be modified by the FORT and LST1 instructions. FO is reset 
to ‘0’. 
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_ Table 3-4. Status Register Field Definitions (Concluded) 


FUNCTION 


Frame Synchronization Mode bit. This bit indicates whether the serial port will operate with or without frame 


FIELD 


sync pulses. When FSM = 1, the serial port operation will be initiated following a frame sync pulse on the ? 
FSX/FSR inputs. When FSM = 0, the FSX/FSR inputs are ignored and the serial port operates continuously 
with no frame sync pulses required. The bit is set to one by a reset. 


Hold Mode bit. When HM = 1, the TMS320C25 halts internal execution when acknowledging an active 
HOLD. -When HM = 0, the processor may continue execution out of internal program memory but puts its 
external interface in a high-impedance state. This bit is set to one by a reset. 








a 5 
= 


TT 
w” 


















INTM Interrupt Mode. A 0’ enables all unmasked interrupts. A ‘1’ disables all maskable interrupts. INTM is set and 
reset by the DINT and EINT instructions. RS and |[ACK also set INTM. INTM has no effect on the unmaskable 


RS interrupt. Note that INTM is unaffected by the LST instruction. 










Overflow Flag. As a latched overflow signal, OV is set to ‘1’ when overflow occurs in the ALU. Once an 
overflow occurs, the OV remains set until a reset, BV, BNV, or LST instruction clears the OV. 


O 
< 











Overflow Mode. A ‘0’ causes overflowed results to overflow normally in the accumulator. A ‘1’ causes the 
accumulator to be set to either its most positive or negative value upon encountering an overflow. The SOVM 
and ROVM instructions set and reset this bit. LST may also be used to modify the OVM. 


Product Shift Mode. If these two bits are 00, the multiplier’s 32-bit product is loaded into the ALU with 
no shift. If PM = 01, the PR output is left-shifted one place and loaded into the ALU, with the LSBs 
zero-filled. If PM = 10, the PR output is left-shifted by four bits and loaded into the ALU, with the LSBs 
zero-filled. PM = 11 produces a right shift of six bits, sign-extended. Note that the PR contents remain 
unchanged. The shift takes place when transferring the contents of the PR to the ALU. PM is loaded with 
the SPM and LST1 instructions. The PM bits are cleared by RS. 


Sign-Extension Mode bit. A 1’ produces sign extension on data as it is passed into the accumulator through 
the scaling shifter. A ‘0’ suppresses sign extension. Note that SXM does not affect the definition of certain 
instructions. For example, the ADDS instruction suppresses sign extension regardless of SXM. This bit is 
set and reset by the SSXM and RSXM instructions and may also be loaded by LST1. SXM is set to ‘1” by 
RS. | 


Test/Control Flag bit. The TC bit is affected by the BIT, BITT, CMPR, LST1, and NORM instructions. The 
_ TC bit is set to a ‘1’ if: (1) a bit tested by BIT or BITT is a ‘1’, (2) a compare condition tested by CMPR exists 
between ARO and another AR pointed to by ARP, or (3) the exclusive-OR function of the two MSBs of the 
accumulator is true when tested by a NORM instruction. Two branch instructions, BBZ and BBNZ, provide 
branching on the status of the TC. 
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TXM Transmit Mode bit. A’1’ configures the serial port’s FSX pin to be an output. In this mode, a pulse is produced 
on FSX when DXR is loaded. Transmission then starts on the DX pin. A ‘0’ configures the FSX pin to be 
an input. TXM is set and reset by the STXM and RTXM instructions and may also be loaded by LST1. RS 
resets TXM to a ‘0’. 





F XF pin status. A status bit indicating the state of the XF pin, a general-purpose output pin. XF is set and reset 


by the SXF and RXF instructions or may be loaded by LST1. XF is set to ‘1’ by RS. 





‘ 


3.4.4 Timer Operation 


The TMS320C25 provides a memory-mapped timer (TIM) register and a period 
(PRD) register. The timer register is a down counter continuously clocked by 
CLKOUT1. Reset sets the timer and period registers (see Figure 3-15) to their 
maximum value (>FFFF). Upon release of reset, the timer begins decrementing. 
Following this, the TIM and PRD registers may be reloaded under program control. 
See Section 3.4.2 for reset information. 
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CRYSTAL 





CLKOUT1 


Figure 3-15. Timer Block Diagram 


The TIM register, data memory location 2, holds the current count of the timer. At 
every CLKOUT1 cycle, the TIM register is decremented by one. The PRD register, 
data memory location 3, holds the starting count for the timer. When the TIM 
register decrements to zero, a TINT (timer interrupt) is generated. In the next cycle, 
the contents of the PRD register are loaded into the TIM register. In this way, a 
TINT is generated every PRD + 1 cycles of CLKOUT1. By programming the PRD 
register from 1 to 65,535 (>FFFF), a TINT can be generated every 2 to 65,536 
cycles, respectively. A PRD register value of zero is not allowed. 


The timer and period registers can be read from or written to on any cycle. The count 
can be monitored by reading the TIM register. Anew counter period can be written 
to the period register without disturbing the current timer count. The timer will then 
start the new period after the current count is complete. If both the PRD and TIM 
registers are loaded with a new period, the timer begins decrementing the new 
period without generating an interrupt. Thus, the programmer has complete control 
of the current and next periods of the timer. | 


lf the timer is not used, TINT should be masked or all maskable interrupts disabled 
by a DINT instruction. The PRD register can then be used as a general-purpose 
data memory location. If TINT is used, the PRD and TIM registers should be 
programmed before unmasking the TINT. 
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3.4.5 Repeat Counter 


The repeat counter (RPTC) is an 8-bit counter, which when loaded with a number 
N, causes the next single instruction to be executed N + 1 times. The RPTC can 
be loaded with a number from 0 to 255 using either the RPT (repeat) or RPTK 
(repeat immediate) instructions. This results in a maximum of 256 executions of a 
given instruction. RPTC is cleared by reset. 


The repeat feature can be used with instructions such as multiply/accumulates 
(MAC/MACD), block moves (BLKD/BLKP), I/O transfers (IN/OUT),-and table 
read/writes (TBLR/TBLW). These instructions, which are normally multicycle, are 
pipelined when using the repeat feature, and effectively become single-cycle 
instructions. For example, the table read instruction may take three or more cycles 
to execute, but when repeated, a table location can be read every cycle. Note that 
not all instructions can be repeated (see Section 4.3 and Appendix E for more 
information). | 


3.4.6 Powerdown Mode 


When operated in the powerdown mode, the TMS320C25 enters a dormant state 
and requires only a fraction of the power normally needed to supply the device. 
Powerdown mode is invoked either by executing an IDLE instruction or by driving 





the HOLD input low with the HM status bit set to one. 


While in powerdown mode, all of the internal contents of the processor are main- 
tained to allow operation to continue unaltered when powerdown mode is termi- 
nated. Powerdown mode is terminated upon receipt of an interrupt when an IDLE 
instruction is being executed or by removal of the HOLD input. (Refer to the IDLE 
instruction description in Section 4 and the hold function description in Section 
3.8.3 for further information.) Actual power supply current requirements in 
powerdown mode are specified in the TMS320C25 Data Sheet (Appendix A). 





3.5 External Memory and I/O Interface 
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Data, program, and |/O address spaces provide interfacing to memory and I/O, thus 


maximizing system throughput. The local memory interface consists of: 


@ A 16-bit parallel data bus (D15-D0), 

@ A 16-bit address bus (A15-A0), \ 

@ Data, program, and I/O space select (DS, PS, and IS) signals, and 
@ Various system control signals. 


The R/W (read/write) signal controls the direction of the transfer, and STRB 
(strobe) provides a timing signal to control the transfer. 


|/O design is simplified by having |/O treated the same way as memory. I/O devices 
are mapped into the |/O address space using the processor’s external address and 
data buses in the same manner aS memory-mapped devices. 


Interfacing to memory and I/O devices of varying speeds is accomplished by using 
the READY line. When communicating with slower devices, the TMS320C25 
processor waits until the other device completes its function, signals the processor 
via the READY line, and continues execution. 
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3.5.1 Memory Combinations 


The exact sequence of operations performed as instructions execute depends on 
the areas in memory where the instructions and operands are located. There are 
six possible combinations of program and data memory since information can be 
located in either internal RAM, external memory, or internal ROM. The six possible 
combinations are: 


Program Internal RAM/Data Internal (PI/D1I) 
Program Internal RAM/Data External (PI/DE) 
Program External/Data Internal (PE/DI!) 
Program External/Data External (PE/DE) 
Program Internal ROM/Data Internal (PR/DIlI) 
Program Internal ROM/Data External (PR/DE) 


Appendix E provides cycle timings for instructions both when repeated and when 
not repeated. The following is a summary of program execution, organized 
according to memory configuration. 


PI/DI or PR/DI When both program and data memory are on-chip, 
the processor runs at full speed with no wait states. 
Note that IN and OUT instructions have different 
cycle timings when program memory is internal; IN 
requires two cycles to execute while OUT requires 
only one. 


PE/DI This memory mode can run at full speed if external 
program memory is sufficiently fast since internal 
data operations can occur coincident with external 
program memory accesses. If external program 
memory is not fast enough, wait states may be 
generated using the READY input. 


PI/DE, PE/DE, or PR/DE Additional cycles are required to execute instructions 
that reference an external data memory space. At 
least two cycles are required to execute ‘read from 
external data memory’ instructions such as ADD, 
LAR, etc. Further additional cycles may be required 
due to wait states if external data memory is not fast 
enough to be accessed within a single cycle. Note, 
however, that the TMS320C25 has the capability of 
executing ‘write to external data memory’ 
instructions in a single cycle when program memory 
is internal (two cycles are required if program 
memory is also external). Additional cycles are also 
required in this case if external data memory is not 
sufficiently fast. 


Note that in all memory configurations where the same bus is used to communicate 
with external data, program, or |/O space, the number of cycles required to execute 
a particular instruction may further vary depending on whether the next instruction 
fetch is from internal or external program memory. Instruction execution and 
operation of the pipeline are discussed in detail in the following sections and in 
Section 3.4.1. 
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3.5.2 Internal Clock Timing Relationships 


The crystal or external clock source frequency is divided to produce an internal 
four- phase clock. The four phases are defined by CLKOUT1 and CLKOUT2, as © 
shown in Figure 3- 16. 


Phase # | Q3 | Q4 | Q1 | a2 | 03 | a4 | 


CLKOUT1 





CLKOUT2 





Q1 


Q2 








Figure 3-16. Four-Phase Clock 


Figure 3-16 shows the start of quarter-phase 3 (Q3) on the rising edge of 
CLKOUT1. To help facilitate the description of the TMS320C25’s operation, this 
nomenclature is used throughout this document. 


3.5.3 External Read Cycle 


Each time an external read cycle is performed, a specific sequence of events occurs. 
This sequence of events is as follows: 


1) 


2) 


3) 


4) 


9) 


During clock quarter-phase 1, the processor begins driving the address bus 
and one of the memory space select signals. R/W is driven high to indicate 
an external memory read. 


At the beginning of quarter-phase 2, STRB is asserted to indicate that the 
address bus is valid. STRB, in conjunction with R/W, may be used to gate a 
read enable signal. 


After decoding the addressed memory area, the user’s memory interface must 
set up the appropriate READY signal during quarter-phase 2. READY is 
sampled by the processor at the beginning of quarter-phase 3. 


If READY was high at the proper time, the data is clocked in at the end of 
quarter-phase 3. | 


STRB is deasserted at the beginning of quarter-phase 4. The 2 processor ends 
the memory access by deactivating the address bus and PS, DS, or IS. 


Note that the control signals PS, DS, IS, STRB, and R/W are only asserted when 
an external address location is being accessed. 
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Figure 3-17 shows the timing for several read operations. Two instructions are 
shown executing completely, an ADD and a SUB instruction. Note that a previous 
instruction is being executed while ADD and SUB are being fetched. Also note that 
while the SUB instruction is being executed, the next instruction, LAC, is being 
fetched even though execution of the LAC is not shown. 


The ADD instruction takes one cycle to execute because both the next instruction 
and the ADD’s data are internal. The SUB instruction that is fetched during ADD 
execution takes two cycles to execute because its data is external. The LAC 
instruction is fetched externally, but no wait state is needed since fast program 
memory is being used. STRB going high (inactive) signals the end of the read cycle. 
Data is clocked into the processor at the beginning of clock quarter-phase 4 if the 
READY signal was active at the beginning of quarter-phase 3 and satisfied the 
required setup time. 


Note that one dummy execute cycle occurs in the sequence of instructions because 
program execution changes from PI to PE. This is discussed in detail in Section 


























Phase # l4:2:31:4141:2:3:4141:2:31:41412:1:31,414121:31:4141 2 
CLKOUT1 
fetch SUB : - NEXT 
: PI/DI : , : : : : : 
external = : a : READ SUB : FETCH : FETCH 
bus : OPERAND LAC NEXT 
PS 
DS 
STRB 
(ARR RRARRARRARARARRARRRARARRARARRRRARRRARARRRRARARARRARARARRR RA VAAAAA AAA 
. $o4 ¢ a4 OY (ARR RRRR RRR RR 
READY OREN UMUC EM UUM EMER EMRE RERER EM EREe MERE ER EERREEXE ED CAAA AAA AVY VY 
R/W 
WOOO AORN LAA 
A1§-A0O ARERR RRR KKK 






ee EX 


D15-DO 7 : : VALID VALID VALID 





Figure 3-17. Read Cycle Functional Timing 
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3.5.4 External Write Cycle 


The sequence of events that occurs each time an external write cycle is performed, 
is as follows: | | | | | | 


1) During clock quarter-phase 1, the TMS320C25 begins driving the address 
bus and one of the memory space select signals. R/W is driven low to indicate 
an external memory write. 


2) At the beginning of quarter-phase 2, STRB is asserted to indicate that the 


address bus is valid. STRB, in conjunction with R/W, may be used to gate a 
write enable signal. 


3) After decoding the addressed memory area, the user’s memory interface must 
provide the appropriate logic level to the READY signal input during quar- 
ter-phase 2. READY is sampled by the processor at the beginning of quar- 
ter-phase 3. 


4) The data bus begins to be driven at the start of quarter-phase 2. 


5) STRB is then deasserted at the beginning of quarter-phase 4. The processor 
ends the memory access by deactivating the address bus and PS, DS, or IS. 


The number of cycles in a memory or |/O access is determined by the state of the 
READY input. At the start of quarter- phase 3, the TMS320C25 samples the READY 
input. If READY is high, the memory access ends at the next falling edge of 
CLKOUT1. If READY is low, the memory cycle is extended by one machine cycle, 
and all other signals remain valid. At the beginning of the next quarter-phase 3, 
this sequence is repeated. Note that for on-chip program and data memory 
accesses, the READY input is ignored. 


Figure 3-18 illustrates the functional timing for write operations and wait states. 
The timing for three instructions, SACL, SAR, and SACH, is shown. The SACL 
instruction stores data in external data memory, and the next instruction fetched 
is in internal program memory. Therefore, the SACL instruction’s memory references 
are PI/DE. SACL only takes one cycle to complete, because the instruction writes 
to the zero wait-state external data memory. The SAR instruction references a PI/DI 
memory configuration. This instruction only takes one cycle to execute, because 
the data and program are internal. The SACH instruction uses slow external data 
memory (one wait state) and fast external program memory. SACH takes three 
cycles: one for the write to external data memory, one for a wait state since the 
external data is slow, and one for the external program fetch. External logic holds 
the READY line inactive during quarter-phase 2 to indicate a wait state. For write 
operations, STRB going high can be used to clock data into the external memory. 





One dummy execute cycle also occurs in this sequence of instructions, because 


program execution changes from PI to PE (see Section 3.4.1). 
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Figure 3-18. Functional Timing of Write Cycles and Wait States 


3.6 Interrupts 


The TMS320C25 has three external maskable user interrupts (INT2-INTO), available 
for external devices that interrupt the processor. Internal interrupts are generated 
by the serial port (RINT and XINT), by the timer (TINT), and by the software 
interrupt (TRAP) instruction. Interrupts are prioritized with reset having the highest 
priority and the serial port transmit interrupt having the lowest priority. 


3.6.1 Interrupt Operation 


This subsection details interrupt organization and management. Vector locations 
and priorities for all internal and external interrupts are shown in Table 3-5. The 
TRAP instruction, used for software interrupts, is not prioritized but is included here 
since it has its own vector location. Each interrupt address has been spaced apart 
by two locations so that branch instructions can be accommodated in those 
locations. 
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Table 3-5. ba Locations and Priorities 


7 INTERRUPT MEMORY 
| ewe oe PRIORITY FUNCTION 
| 5 


1 (highest) External reset signal | 
2 External user interrupt #0 
External user interrupt #1 
External user interrupt #2 
Reserved locations 


Serial port receive interrupt 
7 (lowest) Serial port transmit interrupt 


4 
6 
8-23 | : 
24 Internal timer interrupt 
26 
28 
30 N/A TRAP instruction address 





~ When an interrupt occurs, it is stored in the 6-bit Interrupt Flag Register (IFR). This 


register is set by the external user interrupts INT(2-0) and the internal interrupts 
RINT, XINT, and TINT. Each interrupt is stored until it is recognized and then 
cleared by the IACK (interrupt acknowledge) signal or the RS (reset) signal. The 
RS signal is not stored in the IFR. No instructions are provided for reading from 
or writing to the IFR. 


The TMS320C25 has a memory-mapped Interrupt Mask Register (IMR) for 
masking external and internal interrupts. The layout of the register is shown in 
Figure 3-19. A ‘1’ in bit positions 5 through O of the IMR enables the corre- 


‘sponding interrupt, provided that INTM = 0. The IMR is accessible with both read 
and write operations but cannot be read using BLKD. When the IMR is read, the 


unused bits (15 through 6) will be read as '1’s. The lower six bits are used to write 
to or read from the IMR. Note that RS is not included in the IMR, and therefore 
the IMR has no effect on reset. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
| RESERVED XINT| RINT|TINT|INT2[INT INTO 


Figure 3-19. Interrupt Mask Register (IMR) 





The INTM (interrupt mode) bit, which is bit 9 of status register STO, enables or 
disables all maskable interrupts. A ’O’ in INTM enables all the unmasked interrupts, 
and a ‘1’ disables these interrupts. The INTM is set to a ‘1’ by the IACK (interrupt 
acknowledge) signal, the DINT instruction, or a reset. This bit is reset to a ‘0’ by 
the EINT instruction. Note that the INTM does not actually modify the IMR or IFR. 


The TMS320C25 has a built-in mechanism for protecting multicycle instructions. 
lf an interrupt occurs during a multicycle instruction, the interrupt is not processed 
until the instruction is completed. This also includes instructions that become 
multicycle due to the READY signal. 


In addition, the device also does not allow interrupts to be processed when an 
instruction is being repeated via the RPT or RPTK instructions. The interrupt is 
stored in the IFR until the repeat counter (RPTC) decrements to zero, and then the 
interrupt is processed. Note that even if the interrupt is de-asserted while the 
TMS320C25 is processing the RPT or RPTK, the interrupt will still be latched ny 
IFR and be pending until RPTC decrements to zero. 
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If both the HOLD line and an interrupt go active during a multicycle instruction or 
a repeat loop, the HOLD takes control of the processor at the end of the instruction 
or loop. When HOLD is released, the interrupt is acknowledged. 





Interrupts cannot be processed between EINT and the next instruction in a program 
sequence. For example, if an interrupt occurs during an EINT instruction execution, 
the device always completes EINT as well as the following instruction before the 
pending interrupt is processed. This insures that a RET can be executed before the 
next interrupt is processed, assuming that a RET instruction follows the EINT. The 
state of the machine, upon receiving an interrupt, may be saved and restored (see 
Section 5.3.1). 


3.6.2 External Interrupt Interface 


INT(2-0) may be asynchronous edges or levels. The functional logic organization 

for INT(2-0) is shown in Figure 3-20. As shown in the figure, the external interrupt 

INTO is connected to an edge-triggered flip-flop. The INTO signal is ORed with the 

interrupt edge flip-flop Q output and synchronized with internal quarter-phases 1 

and 2 to produce an interrupt signal. In this way, the device can handle both 
' edge-triggered and level-triggered interrupts. 


If the INTM bit and flag register have been properly enabled, the interrupt signal 
is accepted by the processor. An IACK (interrupt acknowledge) signal is then 
generated. The IACK clears the appropriate interrupt edge flip-flop and disables 
the INTM latch. The logic is the same for INT1 and INT2. 
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Figure 3-20. Internal Interrupt Logic Diagram 


In a typical interrupt (INT2-INTO) operation, the interrupt is generated by a nega- 
tive-going edge and the IFR bit is set. Since INTM is disabled when the interrupt 
is acknowledged, the level may continue to be present on the INT input without 
generating further interrupts. If the level is removed before an EINT instruction is 
executed, no further interrupts are generated. If a low level continues to be present 
after the EINT, another interrupt is generated after the EINT/next instruction 
sequence. In addition, if the INT pin is pulsed between the previous IACK and EINT, 
another interrupt is generated after EINT/RET, because the corresponding IFR bit 
iS again set. 


The timing diagram of Figure 3-21, shows an interrupt, interrupt acknowledge, and 
various other signals for the special case of single-cycle instructions. An interrupt 
generated during the current (N) fetch cycle still allows the fetch and execution 
of that instruction. The N+1 and N+2 instructions are also fetched, then discarded, 
and the address N+1 is pushed onto the top of the stack. The instruction is fetched 
again upon a return command from the interrupt routine. 


As shown in Figure 3-21, two dummy execute cycles occur on an interrupt. The 
IACK signal is asserted low during CLKOUT1 low when the device initiates a fetch 
from interrupt location |. Therefore, an external device can determine the interrupt 
that occurred by latching the address bus value present on A4-A1 with the rising 
edge of CLKOUT2 when IACK is low. 
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Notes: i N is the program memory location for the current instruction. 
2. | is the interrupt vector location in program memory for the active 
interrupt. 


3. For simplicity, this example only shows the execution of single-cycle 
instructions fetched from external program memory, rather than 
multicycle instructions. 


Figure 3-21. Interrupt Timing Diagram 


3.7 Serial Port 


The on-chip serial port provides direct communication with serial devices such as 
codecs, serial A/D converters, and other serial systems. The interface signals are 
compatible with codecs and many other serial devices with a minimum of external 
hardware. The serial port may also be used for intercommunication between 
processors in multiprocessing applications. 


Serial port operation is controlled by the following registers and mode bits: 


Data Transmit Register (DXR) 

Transmit Shift Register (XSR) 

Data Receive Register (DRR) 

Receive Shift Register (RSR) 

Format bit (FO) 

Transmit Mode bit (TXM) 

Frame Synchronization Mode bit (FSM) 


The serial port uses two memory-mapped registers: the DXR register that holds the 
data to be transmitted by the serial port, and the DRR register that holds the 
received data (see Figure 3-22). Any instruction accessing data memory can be 
used to read from or write to these registers; however, the BLKD (block move from 
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data memory to data memory) instruction cannot be used to read these registers. | 
The DXR and DRR registers are mapped into locations O and 1 in the data address 
space. The XSR and RSR registers are not directly accessible through software. 


ADDRESS | 
. MSB LSB 
>0001 DXR 


Figure 3-22. The DRR and DXR Registers 


The transmit and receive sections of the serial port are implemented separately to 
allow independent transmit and receive operations, as shown in Figure 3-23. 
Externally, the serial port interface is implemented using the following six pins on 
the TMS320C25 device: 


Transmitted serial data (DX) 

Transmit clock (CLKX) 

Transmit framing synchronization signal (FSX) 
Received serial data (RX) | 
Receive clock (CLKR) 

Receive framing synchronization signal (FSR) 


The data on the DX and DR pins is clocked out of or into the XSR or RSR by the 
CLKX or CLKR signal, respectively. CLKX and CLKR are only required to be present 
during actual serial port transfers, and may be stopped when no data Is being 
transferred. Data bits can be transferred in either 8-bit bytes or 16-bit words. Data 
is clocked out of XSR on the rising edges of CLKX, while data is clocked into RSR 
on the falling edges of CLKR. The MSB of the data is transferred first. 


The XSR and RSR are connected to the DXR and DRR, respectively. For transmit 
operations, the contents of DXR are transferred to XSR when a new transmission 
begins. For a receive operation, the contents of RSR are transferred to DRR when 
all of the bits have been received. Thus, the serial port is double-buffered since 
data may be transferred to or from the DXR or DRR while another transmit or receive 


- operation is being performed. 
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Figure 3-23. Serial Port Block Diagram 


Serial port transfers are generally initiated by a frame sync pulse. The exception to 
this is when the continuous mode of operation is used with FSM=0, as described 
in a subsequent paragraph. Frame sync pulses are input on FSX for transmit 
operations and on FSR for receive operations. 


Upon completion of a serial port transfer, an internal interrupt is generated. The 
RINT interrupt is generated for a receive operation, and XINT is generated for a 
transmit operation. RINT and XINT are generated on the rising edge of CLKR and 
CLKX, respectively, after the last bit is transferred. Note that if DRR is read before 
a RINT is received, it will contain the data from the previous operation. Similarly, 
if DXR is loaded more than once after an XINT is generated (in the continuous 
transmission mode), only the last value written will be loaded into XSR for the next 
transmit operation. 


When the TMS320C25 is reset, TXM is cleared to zero, and DX is placed in a 
high-impedance state. Any transmit or receive operation that is in progress when 
the reset occurs is terminated. 


If the serial port is not being used, the DRR and DXR registers can be used as 
general-purpose registers. In this case, the CLKR or FSR should be connected to 
a logic low to prevent a possible receive operation from being initiated. 


The FO (format) bit, located in status register ST1, is used to define whether data 
to be transmitted and received is an 8-bit byte or a 16-bit word. If FO = 0, the 
data is formatted in 16-bit words. If FO = 1, the data is formatted in 8-bit bytes. 
In the 8-bit mode, only the lower eight least-significant bits are used for 
transmit/receive operations. The FO bit is loaded by the FORT (format serial port 
registers) instruction. On reset, FO is set to a ‘0’. 
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The TXM (transmit mode) bit, also located in status register ST1, is used to 
determine if the frame sync pulse for the transmit operation is generated internally 
or externally. If TXM=0, FSX is an input, but if TXM=1, FSX becomes an output 
and frame sync pulses are produced on FSX at the beginning of a serial port tran- 
smission. The TXM bit can be loaded by the LST1, STXM, or RTXM instructions. 


The FSM (frame synchronization mode) status register bit is used to select whether 
frame sync pulses are required for each serial port transfer. If FSM=1, frame sync 
pulses are required; if FSM=0O, they are not required. FSM is set by the SFSM (set — 
frame synchronization mode) instruction and cleared by the RFSM (reset frame 
synchronization mode) instruction. 


The timing of the serial port signals is compatible with the Tl/Intel 2910 series 
codecs. The timing is also compatible with the AMI S3506 series codecs if the 
frame synchronization signals are inverted. 


3.7.1 Burst-Mode Operation 


CLKX 


FSX 


(TXM=1) 
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DX 
(FO=1) 


XINT 


LOADED 
(DURING CLKX LOW) 


In burst-mode serial port operation, transfers are separated in time by periods of 
no serial port activity (the serial port does not operate continuously). For burst- 
mode operation, FSM must be set to one. Timing of the serial port in this mode 
of operation is shown in Figure 3-24 and Figure 3-25. 
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Figure 3-24. Burst-Mode Serial Port Transmit Operation 
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Figure 3-25. Burst-Mode Serial Port Receive Operation 


When TXM=1 (in the transmit operation) and the serial port register DXR ts loaded, 
a framing pulse is generated on the next rising edge of CLKX. XSR is loaded with 
the current contents of DXR while FSX is high and CLKX is low. Transmission 
begins when FSX goes low while CLKX is high or is going high. Figure 3-24 shows 
the timing for the byte mode (FO=1). XINT is generated on the rising edge of CLKX 
after all 8 or 16 bits have been transmitted and DX is placed in the high-impedance 
state. If DXR is reloaded before the next rising edge of CLKX after XINT, FSX will 
again be generated as shown, and XSR will be reloaded. 


The receive operation is very similar to the transmit operation. The contents of RSR 
are loaded into DRR while CLKR is low, just after reception of the last bit sent by 
the transmitting device (see Figure 3-25). RINT is generated on the next rising 
edge of CLKR, and DRR may be read at any time before the reception of the final 
bit of the next transmission. When operating in the byte mode, the eight most- 
significant bits of the DRR are the contents of the eight least-significant bits of the 
DRR prior to reception of the current byte, as shown in Figure 3-26. 


Initial 


After 1st Receive 
After 2nd Receive A 
(Byte ‘B’) 


Etc. 


Figure 3-26. Byte-Mode DRR Operation 
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3.7.2 Continuous-Mode Operation Using Frame Sync Pulses 


The. TMS320C25 provides two modes of operation that allow the use of a 
continuous stream of serial data. When FSM=1, frame sync pulses are required, 
but since DXR is double-buffered, continuous operation is achieved even if 


-TXM=1. Writing to DXR during a serial port transmission does not abort the 


transmission in progress, but instead DXR stores that data until XSR can be 
reloaded. As long as DXR is reloaded before the CLKX rising edge on the final bit 
being transmitted, the FSX pulse will go high on the rising edge of CLKX during 
the transmission of the final bit and fall on the next rising edge when transmission 
of the word just loaded begins. If DXR is not reloaded within this period and FSM 
=1, the DX pin will be placed in a high-impedance state for at least one CLKX cycle 
until DXR is reloaded (as described in the previous section). Figure 3-27 and Figure 
3-28 show the timing diagrams for the continuous operation with frame sync 
pulses. | 





FSX 
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Figure 3-27. Serial Port Transmit Continuous Operation (FSM=1) 
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Figure 3-28. Serial Port Receive Continuous Operation (FSM=1) 


Continuous receive operation with FSM=1 is identical to that of burst-mode 
operation with the exception that FSR is pulsed during reception of the final bit. 


3.7.3 Continuous-Mode Operation Without Frame Sync Pulses 


The continuous mode of operation allows transmission and reception of a contin- 
uous bit stream without requiring frame sync pulses every 8 or 16 bits. This mode 
is selected by setting FSM=O. 


Figure 3-29 and Figure 3-30 show operation of the serial port for both states of 
FSM to illustrate differences in operation for each case. FSM is initially set to one, 
and frame sync pulses are required to initiate serial transfers. During processing 
of the next serial port interrupt (XINT or RINT), FSM is reset to zero by means of 
an RFSM (reset FSM) instruction. RFSM can occur either before or after the write 
to DXR or read from DRR. From this point on, the FSX and FSR inputs are ignored, 
with transmission occurring every CLKX cycle and reception occurring every CLKR 
cycle as long as those clocks are present. 
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Figure 3-29. Serial Port Transmit Continuous Operation (FSM=0) 
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Figure 3-30. Serial Port Receive Continuous Operation (FSM=0) 


If FSX is configured as an output, it will remain low until FSM is set back to one 
and DXR is reloaded. If DXR is not reloaded with new data every XINT (every 8 
or 16 CLKX cycles depending on FO), the last value loaded will be transmitted on 
DX continuously. Note that this is different from the case with FSM=1 where DX 
is placed into a high-impedance state if DXR is not reloaded before transmission 
of the last bit of the current word in XSR. For example,if byte C is not loaded into 
DXR as indicated in Figure 3-29, bits B1-B8 will be retransmitted instead of bits 
C1 and C2 as shown. 
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For receive operations, DRR is loaded from RSR (and an RINT is generated) every 
8 or 16 CLKR cycles (depending on FQ), regardless of whether or not DRR has 
been read. An overrun of DRR its also possible with FSM=1 if DRR is not read 
before the next RINT. The only way to stop continuous transmission or reception 
once started, when FSM=0, is to either stop CLKX or CLKR or to perform an SFSM 
(set FSM) instruction. 


Continuous transmission without frame sync pulses is very useful in communicating 
directly to telephone system PCM highways. For AT&T T1 and CCITT G711/712 
lines, FSX and FSR pulses are generated only every 24 or 32 bytes. By counting 
the transmitted and received bytes in software after an initial FSX or FSR and 
performing SFSM and RFSM instructions as required, the TMS320C25 can easily 
be made to communicate in these formats. 


3./.4 Initialization of Continuous-Mode Operation Without Frame Sync Pulses 


FSM is normally initialized during an XINT or RINT service routine to enable or 
disable FSX and FSR, respectively, for the next serial port operation. However, in 
order to initialize the continuous-mode operation, it is permissible to reset FSM to 
zero before a serial port transmit or receive is initiated. As shown in Figure 3-31 
and Figure 3-32, RFSM may occur before a write to DXR, regardless of the state 
of TXM. If TXM=1, FSX is generated in a normal manner on the next rising edge 
of CLKX, but only once. If TXM=0, the TMS320C25 waits to transmit until FSX 
is pulsed, but from then on, the FSX input is ignored. Note that just as in the case 
of continuous-mode operation without sync pulses described in Section 3.7.3, the 
first data written to DXR (byte A) is output twice unless DXR is reloaded before 
the second transmission is started. It is important to consider this dummy cycle 
when using continuous-mode serial operation. 
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Figure 3-31. Continuous Transmit Operation Initialization 


3-43 


Device Operation 





- CLKR 
FSR 


DR 
(Fo=1) 


RINT 





RFSM BRR 
LOADED 
FROM RSR 


Figure 3-32. Continuous Receive Operation Initialization 


The receive timings are the same as those for the transmit operations with TXM=0. 
The TMS320C25 waits to receive data until FSR is pulsed, but thereafter the FSR 
input is ignored. No dummy cycle is associated with the receive operation due to 
the postbuffering nature of DRR as opposed to the prebuffering nature of DXR. 


3.8 Multiprocessing and Direct Memory Access (DMA) 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of 
system requirements. Some of the system configurations using the TMS320C25 
are as follows: 


@ A standalone system (single processor) 


@ A host/slave or parallel multiprocessing system with shared global data 
memory 


@ A host/peripheral coprocessor configuration using interface control signals. 


| These system configurations are made possible by three specialized features of the 
TMS320C25. These three features are the synchronization function utilizing the 
SYNC input, the global memory interface, and the hold function implemented with 
the HOLD and HOLDA pins. The following sections describe these functions in 
detail. | 
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3.8.1 Synchronization 


In a multiprocessor environment, the SYNC input can be used to greatly ease 
interface between processors. This input is used to cause each of the TMS320C25s © 
in the system to synchronize their internal clocks, thereby allowing the processors 
to run in lock-step operation. 


Multiple TMS320C25s are synchronized by using common SYNC and external 
clock inputs. A negative transition on SYNC sets each processor to internal quar- 
ter-phase one (Q1). This transition must occur synchronously with the rising edge 
of CLKIN. The timing diagram for the SYNC input is shown in Figure 3-33. Note 
that there is a two CLKIN cycle delay following the cycle in which SYNC goes low, 
before the synchronized Q1 occurs. 





Phase # Q4 Q1 Q2 Q3 Q1 Q2 Q3 Q4 





CLKIN 


SYNC 


CLKOUT1 


CLKOUT2 





Figure 3-33. Synchronization Timing Diagram 


Normally, SYNC is applied while RS is active. If SYNC is asserted after a reset, the 
following can occur: 


1) The processor machine cycle is reset to Q1, provided that the timing 
requirements for SYNC are met. If SYNC is asserted at the beginning of Q1, 
Q3, or 04, the current instruction is improperly executed. If SYNC is asserted 
at the beginning of Q2, the current instruction is executed properly. 











2) If SYNC does not meet the timing requirements, unpredictable processor 
Operation occurs. A reset should then be executed to place the processor back 
in a known state. 


3.8.2 Global Memory 


For multiprocessing applications, the TMS320C25 has the capability of allocating 
global data memory space and communicating with that space via the BR (bus 
request) and READY control signals. 


Global memory is memory shared by more than one processor; therefore, access 
to it must be arbitrated. When using global memory, the processor's address space 
is divided into local and global sections. The local section is used by the processor 
to perform its individual function, and the global section is used to communicate 
with other processors. 
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A memory-mapped register (GREG) is provided that allows part of data memory 
to be specified as global external memory. GREG, which is memory-mapped at data 


memory address location 5, is an eight-bit register connected to the eight LSBs 


of the internal D bus. The upper eight bits of location 5 are nonexistent and read 
as ‘1's. | ‘ we WE gn Oe | 


The contents of GREG determine the size of the global memory space. The legal 
values of GREG and corresponding global memory spaces are shown in Table 3-6. 
Note that values other than those listed in the table lead to fragmented memory 


“maps. , = 


Table 3-6. Global Data Memory Configurations 


| ; LOCAL MEMORY ~ GLOBAL MEMORY 
GREG VALUE RANGE #WORDS RANGE # WORDS 
000000XX >0 - >FFFF 


10000000 >0O - >7FFF >FFFF 
11000000 >0O - >BFFF >FFFF 


11100000 >O - >DFFF >FFFF 
11110000 >0O - >EFFF >FFFF 
11111000 >0O - >F7FF SEEEE 
11111100 >0 - >FBFF. >FEFF 
11111110 >0 - >FDFF | >FFFF 
11111111 >0 - >FEFF . >PFFF 





When a data memory address, either direct or indirect, corresponds to a global data 
memory address (as defined by GREG), BR is asserted low with DS to indicate that 
the processor wishes to make a global memory access. External logic then arbitrates 
for control of the global memory, asserting READY when the TMS320C25 has 
control. One wait-state timing is shown in Figure 3-34. Note that all signals not 
shown have the same timing as in the normal read or write case. 


Phsew 4 / 1, 2 | 3, 4 1] 4,2 | 3 1 4 | 1 







-CLKOUT1 
STRB 


- A1$-AO 


Figure 3-34. Global Memory Access Timing 
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3.8.3 The Hold Function 


The TMS320C25 supports Direct Memory Access (DMA) to its local (off-chip) 
program, data, and |/O spaces. Two signals, HOLD and HOLDA, are provided to 
allow another device to take control of the processor's buses. Upon receiving a 
HOLD signal from an external device, the processor acknowledges by bringing 
HOLDA low. The processor then places its address and data buses as well as all 
control signals (PS, DS, IS, R/W, and STRB) in the high-impedance state. The serial 
port output pins, DX and FSX, are not affected by HOLD. 





The timing for the HOLD and HOLDA signals is shown in Figure 3-35. HOLD has 
the same setup time as READY and is sampled at the beginning of quarter-phase 
3. If the setup time is met, it takes three machine cycles before the buses and control 
signals go to the high-impedance state. Note that unlike the external interrupts 
INT(2-0), HOLD is not a latched input. The external device must keep HOLD low 
until it receives a HOLDA from the TMS320C25. 








The hold function has two distinct operating modes, which are selected by the 
HM (hold mode) status register bit. The HOLD signal is pulled low, as shown in 
the first part of Figure 3-35. When HM=1, the TMS320C25 halts program 
execution and enters the hold state directly. When HM=0, the processor enters 
the hold state directly, as shown in Figure 3-35, if program execution is from 
external memory or if external data memory is being accessed. If program execution 
is from internal memory, however, and if no external data memory accesses are 
required, the processor enters the hold state externally, but program execution 
continues internally. This allows more efficient system operation since a program 
may continue executing while an external DMA operation is being performed. 


Note that if the processor is in a hold state with HM=0O and an internally executing 
program requires an external access, or if the program branches to an external 
address, program execution ceases until HOLD is removed. Also, if a repeat 
instruction that requires the use of the external bus is executing with HM=0 and 
a hold occurs, the hold state is entered after the current bus cycle. If this situation 
occurs with HM=1, the hold state will not be entered until the repeat count is . 
completed. HM is set and reset by the SHM (set hold mode) and RHM (reset hold 
mode) instructions, respectively. 





If the TMS320C25 is in the middle of a multicycle instruction, it will finish the 
instruction before entering the hold state. After the instruction is completed, the 
buses are placed in the high-impedance state. This also applies to instructions that 
become multicycle due to insertion of wait states. 


After HOLD is de-asserted, program execution resumes from the same point at 
which it was halted. HOLDA is removed synchronously with HOLD, as shown in 
Figure 3-35. If the setup time is met, two machine cycles are required before the 
buses and control signals become valid. 








All interrupts are disabled while HOLD is active with HM=1. If an interrupt is 
received during this period, the interrupt is latched and remains pending. HOLD 
itself does not affect any interrupt flags or registers. If HM=0, interrupts function 
normally. 


HOLD is not treated as an interrupt. If the TMS320C25 was executing the IDLE 
instruction before entering the hold state, it resumes executing IDLE once it leaves 
the hold state. 
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Phase # — aig 248 A) ig 2a Sal 1g By Oe Tes 8 4 







CLKOUT1 


STRB 


~ execute 


-HOLDA 


Notes: 1. Nis the program memory location for the current instruction. 
2. This example only shows the execution of single-cycle instructions 
fetched from external program memory. 


Figure 3-35. Hold Timing Diagram 
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Phase # 14:21:31:41212:39.4111:2:3,41141:2:3,4/1 112: 3: 41 11 2: 31 4 
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Figure 3-35. Hold Timing Diagram (Concluded) 


3.9 General-Purpose I/O Pins 


The TMS320C25 has two general-purpose pins that are software-controlled. The 
BIO pin is a branch control input pin, and the XF pin is an external flag output pin. 


3.9.1 BIO Input 


When the BIO input pin is active (low), execution of the BIOZ instruction causes 
a branch to occur. 


The BIO pin is useful for monitoring peripheral device status. It is especially useful 
as an alternative to using an interrupt when it is necessary not to disturb time-cri- 
tical loops. 


Figure 3-36 shows the BIO timing diagram. BIO is sampled at the end of quar- 
ter-phase 4. Note that the timing diagram shown is for a sequence of single-cycle, 
single-word instructions without branches located in external memory. Because 
of variations in pipelining due to instructions prior to and following the BIOZ 
instruction, this timing may vary. Therefore, it is recommended that several cycles 
of setup be provided if BIO is to be recognized on a particular cycle. 
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Figure 3-36. BIO Timing Diagram 


3.9.2 External Flag Output 


The XF (external flag) output pin is set to a high level by the SXF (set external flag) 
instruction and reset to a low level by the RXF (reset external flag) instruction. XF 


is set high by RS. 


The relationship between the time the SXF/RXF instruction is fetched before the 
XF pin is set or reset is shown in Figure 3-37. As with BIO, the timing shown for 
XF is for a sequence of single-cycle, single-word instructions located in external 


memory. Actual timing may vary with different instruction sequences. 
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Phase # l4121:31:41411:21:3:4111:21:31:411121314| 


CLKOUT! NX J YJ Vv SJ YS NX 





A15-A0O 





: (SXF OR RXF) ; 
jetoh: “eg ee 


“« — macau 3 
em 
_- , , , 
(RXF) \ 


Notes: 1. Nis the program memory location for the current instruction. 
2. This example only shows the execution of single-cycle instructions 
fetched from external program memory. 


4 N+2 N+3 . 


Figure 3-37. External Flag Timing Diagram 
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4. Assembly Language Instructions 


The TMS320C25 instruction set supports numeric-intensive signal processing 
operations as well as general-purpose applications, such as multiprocessing and 
high-speed _ control. TMS32010 source code is upward-compatible with 
TMS320C25 source code. TMS32020 object code is upward-compatible with 
TMS320C25 object code. 


This section describes the assembly language instructions for the TMS320C25 
microprocessor. Included in this section are the following major topics: 


@ Memory Addressing Modes (Section 4.1 on page 4-2) 
Direct addressing 
Indirect addressing (using eight auxiliary registers) 
Immediate addressing 


® Instruction Set (Section 4.2 on page 4-8) 
Symbols and abbreviations used in the instructions 
Instruction set summary (listed according to function) 


® Individual Instruction Descriptions (Section 4.3 on page 4-13) 
Presented in alphabetical order and providing the following: 
- Assembler syntax 
- Operands 
- Execution 
- Encoding 
- Description 
- Words 
- Cycles 
- Repeatability 
- Example(s) 


4-1 


Assembly Language Instructions 


4.1 Memory Addressing Modes 


The TMS320C25 instruction set provides three memory addressing modes: 


®@ Direct addressing mode 
© Indirect addressing mode 
@ Immediate addressing mode 


Both direct and indirect addressing can be used to access data memory. Direct 
addressing concatenates seven bits of the instruction word with the nine bits of the 
data memory page pointer to form the 16-bit data memory address. Indirect 
addressing accesses data memory through the eight auxiliary registers. In immediate 
addressing, the data is based on a portion of the instruction word(s). The following 
sections describe each addressing mode and give the opcode formats and some 
examples for each mode. 


4.1.1 Direct Addressing Mode 


4-2 


In the direct memory addressing mode, the instruction word contains the lower seven 


bits of the data memory address (dma). This field is concatenated with the nine bits 
of the data memory page pointer (DP) register to form the full 16-bit data memory 
address. Thus, the DP register points to one of 512 possible 128-word data memory 
pages, and the 7-bit address in the instruction points to the specific location within 
that data memory page. The DP register is loaded through the LDP (load data memory 
page pointer), LDPK (load data memory page pointer immediate), or LST (load status 
register STO) instructions. Figure 4-1 illustrates how the 16-bit data address is 
formed. | 





7 LSBS FROM 
INSTRUCTION 
REGISTER (IR) 





16-BIT DATA ADDRESS 


Figure 4-1. Direct Addressing Block Diagram 


Direct addressing can be used with all instructions except CALL, the branch 
instructions, immediate operand instructions, and instructions with no operands. The 
direct addressing format is as follows: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 +0 


| Opcode dma 


Bits 15 through 8 contain the opcode. Bit 7 = O defines the addressing mode as 
direct, and bits 6 through O contain the data memory address (dma). 
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Example of Direct Addressing Format: 


ADD 9,5 Add to accumulator the contents of data memory location 9 left- 
shifted 5 bits. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 «0 
0 0 0 001 0 1;/0/0 0 0 1 0 0 1 


The opcode of the ADD 9,5 instruction is >05 and appears in bits 15 through 8. The 
notation >nn indicates nn is a hexadecimal number. The shift count of >5 appears 
in bits 11 through 8 of the opcode. The data memory address >09 appears in bits 
6 through 0. 


4.1.2 Indirect Addressing Mode 


The eight auxiliary registers (ARO-AR7) provide flexible and powerful indirect 
addressing. To select a specific auxiliary register, the Auxiliary Register Pointer (ARP) 
is loaded with a value from O through 7, designating ARO through AR7, respectively 
(see Figure 4-2). 


The contents of the auxiliary registers may be operated upon by the Auxiliary Register 
Arithmetic Unit (ARAU), which implements 16-bit unsigned arithmetic. The ARAU 
performs auxiliary register arithmetic operations in the same cycle as the execution 
of the instruction. (Note that the increment or decrement of the indicated AR Is 
always executed after the use of that AR in the instruction.) 








AUXILIARY 
7 REGISTERS 
|_ARB (3) [+ 















ARAU (16 
16-BIT DATA ADDRESS 


Figure 4-2. Indirect Addressing Block Diagram 


In indirect addressing, any location in the 64K data memory space can be accessed 
via the 16-bit addresses contained in the auxiliary registers. These may be loaded 
by the instructions LAR (load auxiliary register), LARK (load auxiliary register 
immediate), and LRLK (load auxiliary register long immediate). The auxiliary registers 
may be modified by ADRK (add to auxiliary register short immediate) or SBRK 
(subtract from auxiliary register short immediate). The auxiliary registers may also 
be modified by the MAR (modify auxiliary register) instruction or, equivalently, by 
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the indirect addressing field of any instruction supporting indirect addressing. 
AR(ARP) denotes the auxiliary register selected by ARP. 


The following symbols are used in indirect addressing: 


* 


Contents of AR(ARP) are used as the data memory address. 


* 


- Contents of AR(ARP) are used ; as the data memory address, then decre- 
mented after the access. 


me Contents of AR(ARP) are used as the data memory address, then incre- 
mented after the access. 


“O- = Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO subtracted from it after the access. 


*O+ Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO added to it after the access. 


~ *BRO- Contents of AR(ARP) are used as the data ‘memory address, and they 


contents of ARO subtracted from it (with reverse carry propagation) after 
the access. 


*“BRO+ Contents of AR(ARP) are used as the data memory address, and the 
contents of ARO added to it (with reverse carry propagation) after the access. 


There are two main types of indirect addressing with indexing: 


@ Regular indirect addressing with increment or decrement, and 
@ Indirect addressing with indexing based on the value of ARO. 


In either case, the contents of the auxiliary register pointed to by the ARP register 
are used as the address of the data memory operand. Then, the ARAU performs the 
specified mathematical operation on the indicated auxiliary register. Additionally, the 
ARP may be loaded with a new value. 


Indirect auxiliary register addressing allows for post-access adjustments of the 
auxiliary register pointed to by the ARP. The adjustment may be an increment or 
decrement by one or based upon the contents of ARO. 


Indirect addressing can be used with all instructions except immediate operand | 
instructions and instructions with no operands. The indirect addressing format is 
as follows: 


15 14 13 12 #41 #10 @Q 


8 7 6 5 4 3 2 1 0 


Bits 15 through 8 contain the opcode, and bit 7 = 1 defines the addressing mode 
as indirect. Bits 6 through O contain the indirect addressing control bits. 


Bit 6 contains the increment/decrement value (IDV). The IDV determines whether 
ARO will be used to increment or decrement the current auxiliary register. If bit 6 = 
0, an increment or decrement (if any) by one occurs to the current auxiliary register. 
If bit 6 = 1, ARO may be added to or subtracted from the current auxiliary register 
as defined by bits 5 and 4. 


Bits 5 and 4 control the arithmetic operation to be performed with AR(ARP) and 
ARO. When set, bit 5 indicates that an increment is to be performed. If bit 4 is set, a 
decrement is to be performed. Table 4-1 shows the correspondence of bit pattern 
and arithmetic operation. | 
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Table 4-1. Indirect Addressing Arithmetic Operations 


BITS ARITHMETIC OPERATION 
5 


No operation on AR(ARP) 
AR(ARP) - 1 ~ AR(ARP) 
AR(ARP) + 1 ~ AR(ARP) 

Not used 

AR(ARP) - ARO ~ AR(ARP) [reverse carry propagation] 
AR(ARP) - ARO > AR(ARP) 

AR(ARP) + ARO ~ AR(ARP) 

AR(ARP) + ARO ~ AR(ARP) [reverse carry propagation] 
















--=3O0O00 --00 
-oO-O-0-OCO/]f 


Bit 3 and bits 2 through O control the Auxiliary Register Pointer (ARP). Bit 3 (NAR) 
determines if a new value is loaded into the ARP. If bit 3 = 1, the contents of bits 
2 through O (Y = next ARP) are loaded into the ARP. If bit 3 = 0, the contents of 
the ARP remain unchanged. 


Table 4-2. Bit Fields for Indirect Addressing 


NOTATION OPERATION 
0 : 


INSTRUCTION FIELD BITS 
15 14 13 12 #11 += «210 


98765 43 2 1 





OPCODE 
OPCODE 
OPCODE 
OPCODE 


OPCODE 
OPCODE 


OPCODE 
OPCODE 


OPCODE 
OPCODE — 


OPCODE 
OPCODE 


OPCODE 
OPCODE 


No manipulation of ARs/ARP 
Y ~ ARP 

AR(ARP)-1 — AR(ARP) 
AR(ARP)-1 — AR(ARP); 

Y — ARP 

AR(ARP)+1 — AR(ARP) 
AR(ARP)+1 — AR(ARP); 

Y — ARP 

AR(ARP)-rcARO ~ AR(ARP)T 
AR(ARP)-rcARO ~ AR(ARP); 
Y—> ARPT — 

AR(ARP)-ARO — AR(ARP) 
AR(ARP)-ARO — AR(ARP); 

Y — ARP 

AR(ARP)+ARO —~ AR(ARP) 
AR(ARP)+ARO > AR(ARP); 
Y — ARP 

AR(ARP)+rcARO ~ AR(ARP)T 
AR(ARP)+rcARO — AR(ARP); 
Y ~ ARPT 


Trc = reverse carry propagation 


For some instructions, the notation in Table 4-2 includes a shift code, e.g., *0+,8,3 
where 8 is the shift code and Y = 3. 


The CMPR (compare auxiliary register with ARO), and BBZ/BBNZ (branch if TC bit 
equal/not equal to zero) instructions facilitate conditional branches based on 
comparisons between the contents of ARO and the contents of AR(ARP). 


The auxiliary registers may also be used for temporary storage via the load and store 
auxiliary register instructions, LAR and SAR, respectively. 
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- Example 1: 


ADD *+,8 


15 14 13 


~ The-following examples illustrate the indirect addressing format: 


Add to the accumulator the contents of the data memory address 


defined by the contents of the current auxiliary register. This data 
is left-shifted 8 bits before being added. The current auxiliary 
register is autoincremented by one. The opcode is >O8A0, as 
shown below. | 


et 4 3 2 1 #0 


0 0 0 0 1 Oj; 1 0 0 0 0 


_ Example 2: 


ADD *,8 


Example 3: 


ADD *-,8 


Example 4: 
ADD *0+,8 


Example 5: 


ADD *0-,8 


Example 6: 
ADD “*+,8,3 


Example 7: 


ADD *BRO-,8 | 


Example 8: 


ADD *BRO+,8 


As in Example 1, but with no autoincrement; the opcode is >0880. 


As in Example 1, except that the current auxiliary register is 
decremented by one; the opcode is >0890. 


As in Example 1, except that the contents of auxiliary register ARO 
are added to the current auxiliary register; the opcode is >O8EO. 


As in Example 1, except that the contents of auxiliary register ARO 
are subtracted from the current auxiliary register; the opcode is 
>O08DO. 


As in Example 1, except that the auxiliary register pointer (ARP) 
is loaded with the value 3 for subsequent instructions; the opcode 
is >O8AB. | 


The opcode is >O8CO. The contents of auxiliary register ARO are 
subtracted from the current auxiliary register with reverse carry 
propagation. 


The opcode is >O8FO. The contents of auxiliary register ARO are 
added to the current auxiliary register with reverse carry propa- 
gation. 


Assembly Language Instructions 


4.1.3 Immediate Addressing Mode 


In immediate addressing, the instruction word(s) contains the value of the immediate 
operand. The immediate operand may be contained within the instruction word itself 
or in the word following the opcode. 


The following instructions contain the immediate operand in the instruction word 
and execute within a single instruction cycle. The length of the constant operand is 
instruction-dependent. 


ADDK 
ADRK 
LACK 
LARK 
LARP 
LDPK 
MPYK 
RPTK 
SBRK 


SUBK 


Add to accumulator short immediate (8-bit absolute constant) 

Add to auxiliary register short immediate (8-bit absolute constant ) 
Load accumulator immediate short (8-bit absolute constant) 

Load auxiliary register immediate short (8-bit absolute constant) 
Load auxiliary register pointer (3-bit constant) 

Load data memory page pointer immediate (9-bit constant) 
Multiply immediate (13-bit two’s-complement constant) 

Repeat instruction as specified by immediate value (8-bit constant) 


Subtract from auxiliary register short immediate (8-bit absolute 
constant) 


Subtract from accumulator short immediate (8-bit absolute constant). 


For the other immediate instructions, the constant is a 16-bit value in the word 
following the opcode. The 16-bit value can be optionally used as an absolute 
constant or as a two’s-complement value. 


ADLK 


ANDK 
LALK 


LRLK 
ORK 
SBLK 


XORK 


Add to accumulator long immediate with shift (absolute or two’s 
complement) 


AND immediate with accumulator with shift 


Load accumulator long immediate with shift (absolute or two’s 


- complement) 


Load auxiliary register long immediate 
OR immediate with accumulator with shift 


Subtract from accumulator long immediate with shift (absolute or two’s 
complement) 


Exclusive-OR immediate with accumulator with shift. 
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The following examples illustrate immediate addressing format: 
Example 1: | 


ADLK 16384,2 Add to the accumulator the value 16384 with a shift to the left 
of two, effectively adding 65536 to the contents of the accu- 
mulator. | | 


The ADLK instruction uses the word following the instruction opcode as the imme- 
diate operand. The instruction format for ADLK is as follows: 


15 14 1312 1110 9 8 7 6 56 4 3 2 1 «0 


- 16-Bit Constant 


Example 2: si 


RPTK 99 Execute the instruction following this instruction 100 times. 


With the RPTK instruction, the immediate operand is contained as a part of the 
instruction opcode. The instruction format for RPTK is as follows: 


15 14 13 12 11109 8 7 6 56 4 3 2 1 «0 


4.2 Instruction Set 


The following sections list the symbols and abbreviations used in the instruction set 
summary and in the instruction descriptions. The complete instruction set summary 
is Organized according to function. A detailed description of each instruction is listed 
in the instruction set summary. 


4.2.1 Symbols and Abbreviations 


4-8 





Table 4-3 lists symbols and abbreviations used in the instruction set summary (Table 
4-4) and the individual instruction descriptions. 
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- Table 4-3. Instruction Symbols 


SymBoL] MEANING 


Accumulator 

Auxiliary register pointer buffer 

Auxiliary Register n (ARO through AR7 are predefined 
assembler symbols equal to 0 through 7, respectively. ) 
Auxiliary register pointer 

4-bit field specifying a bit code 

Branch control input 

Carry bit 

2-bit field specifying compare mode 

On-chip RAM configuration control bit 

Data memory address field 

Label assigned to data memory location n 

Data memory address 

Data page pointer 

Format status bit 

Frame synchronization mode bit 

Hold mode bit 

Addressing mode bit 

Interrupt mode flag bit 

Immediate operand field 

Indicates nn is a hexadecimal number. (All others are 
assumed to be decimal values.) 

Overflow mode flag bit 

Overflow mode bit 

Product register 

Port address (PAO through PA15 are predefined assembler 
symbols equal to 0 through 15, respectively.) 

Program counter 

2-bit field specifying P register output shift code 

Program memory address 

Label assigned to program memory location n 

3-bit operand field specifying auxiliary register 

Repeat counter 

4-bit left-shift code 

Status register n (STO or ST1) 
Sign-extension mode bit 
Temporary register 

Test control bit 

Top of stack 

Transmit mode bit 

3-bit accumulator left-shift field 

XF pin status bit 

Is assigned to 

An absolute value 

User-defined items 

Optional items 

Contents of 

Alternative items, one of which must be entered 
Blanks or spaces must be entered where shown. 





4.2.2 Instruction Set Summary 


The instruction set summary of Table 4-4 is arranged according to function and 
alphabetized within each functional grouping. Additional information is presented 
in the individual instruction descriptions in the following section. The symbol T 
indicates instructions that are not included in the TMS32010 instruction set. The 
symbol # indicates instructions that are not included in the TMS32020 instruction 
set. 
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Table 4-4. Instruction Set Summary 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 





MNEMONIC DESCRIPTION INSTRUCTION BIT CODE 


1514131211109 8 76543 210 
Absolute value of accumulator 
Add to accumulator with shift 
Add to accumulator with carry 
Add to high accumulator 
Add to accumulator short immediate 
Add to low accumulator with sign 
extension suppressed 
Add to accumulator with shift specified by 
T register 
_ Add to accumulator long immediate with shift | 
AND with accumulator | 
AND immediate with accumulator with shift 
Complement accumulator 
Load accumulator with shift 
Load accumulator immediate short 
Load accumulator with shift specified by T register 
Load accumulator long immediate with shift 
Negate accumulator | 
Normalize contents of accumulator 
OR with accumulator 
OR immediate with accumulator with shift 
Rotate accumulator left 
Rotate accumulator right 
Store high accumulator with shift 
Store low accumulator with shift 
Subtract from accumulator long immediate with shift 
Shift accumulator left 
Shift accumulator right 
Subtract from accumulator with shift 
Subtract from accumulator with borrow 
Conditional subtract 


----9o000--000-=00- 


Subtract from high accumulator 
Subtract from accumulator short immediate 


ooooo0o0o0o0°o0o -re oOo o0o0co0o0o0o0co oOo - 000 :0 
ooo oo poor oo0ocor O90 Oo fF OOO CO aH O'= 


Subtract from low accumulator with sign 


extension suppressed 

Subtract from accumulator with shift specified by 
T register 

Exclusive-OR with accumulator 

Exclusive-OR immediate with accumulator with shift 
Zero accumulator . 

Zero low accumulator and load high accumulator 
Zero low accumulator and load high accumulator 
with rounding 

Zero accumulator and load low accumulator with 
sign extension suppressed 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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Assembly Language Instructions 





Table 4-4. Instruction Set Summary (Continued) 





AUXILIARY REGISTERS AND DATA PAGE POI 





MNEMONIC 


ADRK# 
CmpPRt 
LAR 
LARK 
LARP 
LDP 
LDPK 
LRLKt 
MAR 
SAR 
SBRKt 


MNEMONIC 


DESCRIPTION 


Add to auxiliary register short immediate 
Compare auxiliary register with auxiliary register ARO 
Load auxiliary register 

Load auxiliary register short immediate 

Load auxiliary register pointer 

Load data memory page pointer 

Load data memory page pointer immediate 
Load auxiliary register long immediate 

Modify auxiliary register 

Store auxiliary register 

Subtract from auxiliary register short immediate 


NO. 
WORDS 


= —| =| Oo = —_—_ = = — = = 


NTER INSTRUCTIONS 


INSTRUCTION BIT CODE 


1514131211109 8765 43 210 





O11 14 141 1 1 0<¢—-K——>r 
110014 110010 1 0 0<CMr> 
00110 ~<+#R> | <——\—D)D—> 
11000 Se 
0101010311000 1 <«-R-> 
OT, O° 0-0) Of 
Td. SO: Oh ot: OO. $$ > —— 1B 
110310 +R” 000000 0 0 
OO 1°00 9 0. 74-900 A te 
Oo. 1). A = RS ee DS 
Oh teh Th) ———— 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


DESCRIPTION 





APAC 
LPHT 
LT 
LTA 
LTD 


LTPT 
LTst 
mMaAct 
MaAcbDt 
MPY 
MPYA+ 
MPYK 
mMpyYs? 
mpyut 
PAC 
SPAC 
SPH+ 
SPL# 
sPpmt 
SQRAt 
sarst 


TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 


Add P register to accumulator 

Load high P register 

Load T register 

Load T register and accumulate previous product 
Load T register, accumulate previous product, 
and move data 

Load T register and store P register in accumulator 
Load T register and subtract previous product 
Multiply and accumulate 

Multiply and accumulate with data move 
Multiply (with T register, store product in P register) 
Multiply and accumulate previous product 
Multiply immediate 

Multiply and subtract previous product 

Multiply unsigned 

Load accumulator with P register 

Subtract P register from accumulator 

Store high P register 

Store low P register 

Set P register output shift mode 

Square and accumulate 


- Square and subtract previous product 


= — — == - —-— —-— | =| — — =| AQ AQ —= — 


INSTRUCTION BIT CODE 


1514131211109 8 7 6 
O 1 O 





OoO0oO0 0 => 
oOooO0o0- 
- -—- = O — 


1 
O 
1 
1 
1 


=- OOo - 


1 
1 
1 
1 


=-0O000- = 
oOoO0 - + Oo 
| 


+——___D——___> 
000 1 0<PM> 
SD 
<+___D—___> 


Ooo ff] 00 fF ff] fF OoOrP- ooo oO Oo 6 
Oor-eorj--r-ooo0oor-,-- = 000-4 
orp-o7°oeoerf-0o0f+ = 
a a a Se DD a 

© 

oO 

© 

© 
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| Assembly Language Instructions 





Table 4-4. Instruction Set Summary (Continued) 


BRANCH/CALL INSTRUCTIONS 











‘MNEMONIC — ; DESCRIPTION ace : | RE See enae neee eet 
| 1914131211109 8765 43210 
B Branch unconditionally 2 11171379413 13%3%331e———D———— > 
BAccT Branch to address specified by accumulator 1 1100314110001 00%10 =41 
BANZ Branch on auxiliary register not zero 2 1111411071311 -——)D)—— > 
BBNzt Branch if TC bit + 0 2 171174110011 <«————D——» 
BBzt Branch if TC bit = 0 2 111110001 <«<——\)———» 
Bct Branch on carry 2 010111101 <«———\)——» 
BGEZ Branch if accumulator > O 2 1111031001 <——D)——» 
BGZ Branch if accumulator > O 2 111713100031 1«——D-—-——> 
BIOZ Branch on I/O status = O 2 1711711711038 0 4 ———D———— > 
BLZ Branch if accumulator < O 2 1711110011 1 «———\)——» 
BNCt Branch on no carry 2 010111111 +——O)———»> 
BNvt Branch if no overflow 2 11110141311 —+——D)——» 
BNZ Branch if accumulator # O 2 tr? E.oero?) ips 
BV Branch on overflow 2 1171143100001. <+——D)D-——> 
BZ Branch if accumulator = O 2 1114310314101 «———D-——— > 
CALA Call subroutine indirect 1 11003114 1090003131 00.1 0 0 
CALL Call subroutine 2 17131431313 313%31%101——D)D——— > 
1 1100111000313001 1 0 


RET Return from subroutine 





1/0 AND DATA MEMORY OPERATIONS | 
NO. INSTRUCTION BIT CODE 


MNEMONIC DESCRIPTION 








were 1814131211109 876543210 
BLKD Block move from data memory to data memory 2 1173373313707 ' D> 
BLKPt Block move from program memory to data memory 2 11131431711720010——D-——> 
DMOV Data move in data memory | 1 010101108 «——)—— >» 
FORT? Format serial port registers 1 1100111000001 1 1F0 
IN Input data from port 1 1000 <«—PA—> | <——)D— > 
OUT Output data to port 1 1110 <@«—-PA—> | <«<——)D-—> 
RFSM?# Reset serial port frame synchronization mode 1 1100314 1%131%0e00381 1 014 1 90 
RTXmMt Reset serial port transmit mode 1 110031%%1%%1%0e00%100000 
RXFT Reset external flag 1 117100111000001100 
‘SFSMt Set serial port frame synchronization mode 1 110031411 090e00381 071 1 ~=41 
STxmt Set serial port transmit mode 1 1100111000100001 
SxXFT Set external flag 1 11001110000031101 
TBLR Table read 1 010110001 «+ —)D——» 
TBLW Table write 1 010110 0180——)D-—-—— > 


TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 


Assembly Language Instructions 


Table 4-4. Instruction Set Summary (Concluded) 


CONTROL INSTRUCTIONS 





MNEMONIC 





BIT 
BITTT 
CNFDt 
CNFPT 
DINT 
EINT 
IDLET 
LST 
LsTit 
NOP 
POP 
POPpDt 
PSHDt 
PUSH 
Rc# 
RHM# 
ROVM 
RPTT 
RPTKT 
RSXMT 
RTct 
sct 
SHM+ 
SOVM 
SST 
ssTit 
SSxmt 
sTct 
TRAPt 


NO. INSTRUCTION BIT CODE 


DESCRIPTION 
WORDS 


1514131211109 8 765 43 2 10 





Test bit 1 1001-<*#—B— | <——)D—— > 
Test bit specified by T register 1 0101011 1 ) «&——D—————> 
Configure block as data memory 1 11007141 1000000 1 0 0 
Configure block as program memory 1 11001414 100000071 0 +41 
Disable interrupt 1 11001414 1000000 0 0° 1 
Enable interrupt 1 1100114 10000000 0 0 
Idle until interrupt 1 117100141 1000071 4 44 ~=1~=-4 
Load status register STO 1 01010000 | &————> 
Load status register ST1 1 010310001 | «#——D-—_—> 
No operation 1 O101.0101 000000 0 0 
Pop top of stack to low accumulator 1 17100141 1000071 1 717 0°41 
Pop top of stack to data memory 1 OP PD Pee TO —_—_——— b= > 
Push data memory value onto stack 1 01010%100/t1+~——D—> 
Push low accumulator onto stack 1 1100141 100004810 1:1 0 0 
Reset carry bit 1 1100141100011 00 0 0 
Reset hold mode 1 11001414 10008178 100 0 
Reset overflow mode 1 1100141 1000000071 0 
Repeat instruction as specified by data mem:::y value 1 01001011 1 <«——D———> 
Repeat instruction as specified by immediate value 1 17100310780 1 <«——_K—————_ 
Reset sign-extension mode 1 11001414 100000081 1 0 
Reset test/control flag 1 110014 110008087 00 1 0 
Set carry bit 1 11001414 100011000841 
Set hold mode 1 1100%1-1 10001 1 100 =74 
Set overflow mode 1 11003141341 10000000 1 +41 
Store status register STO 1 O11 110001 ~*——D——> 
Store status register ST1 1 0O1114%100%1i1 +—D——r 
Set sign-extension mode 1 11001414 1000000 1 74 ~=+41 
Set test/control flag 1 11001414 100071100 1°71 
Software interrupt 1 1100311 100008114 1 1 +0 


tThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 


4.3 Individual Instruction Descriptions 


Each instruction in the instruction set summary is described in the following pages. 
Instructions are listed in alphabetical order. Information, such as assembler syntax, 
operands, operation, encoding, description, words, cycles, repeatability, and exam- 
ples, is provided for each instruction. An example instruction is provided to familiarize 
the user with the special format used and explain its content. Refer to Section 4.1 
for further information on memory addressing. Code examples using many of the 
instructions are given in Section 5 on Software Applications. 





so: Direct:Addressing: 
Indirect Addressing: 
Immediate Addressing: 


__ operand values used in the example syntax areshown. =-—s—is—dr=—si=—sdi—r“— i‘“swswsi‘(aié‘( 


Operands 
Execution 
Encoding 
Direct 
indirect 


Short immediate 


Long Immediate 





[<label>] EXAMPLE <dma>[,<shift>]. — 


[<label>] EXAMPLE {*|*+1*-|*0-+|*0-|* BRO+|*BRO-}[,<shift> [,<nextARP>]] 
[<label>] EXAMPLE [<constant>] S See BRS 


Each instruction begins with an assembler syntax expression. The optional 
comment field that concludes the syntax is not included in the syntax expression. 
Space(s) are required between each field (label, command, operand, and 
comment fields) as shown in the syntax. The syntax example illustrates both direct 
and indirect addressing, as well as immediate addressing in which the operand 
field includes <constant>. : 


0 < dma s 127 
O < next ARP s 7 
O < constant < 255 


Operands may be constants or assembly-time expressions referring to memory, 
1/O and register addresses, pointers, shift counts, and a variety of constants. The 


(PC) +17 PC 
(ACC) + [(dma) x 2shift] + ACC 


lf SXM = 1: | 
Then (dma) is sign-extended. 


If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by OVM and SXM. 


This section provides an example of the instruction operation sequence, describing 
the processing that takes place when the instruction is executed. Conditional 
effects of status register specified modes are also given. In addition, those bits in 
the status registers that are affected by the instruction are listed. 


15 14 13 12 11°10 9 8 7 6 56 4 3 2 1 «0 
0 OO O Data Memory Address 


0 0 O OQ See Section 4.1 
pio o 1 oO 4 tf 8-Bit Constant 
11 o 41} shit [0 © 0 0 0 oO 1 0 


16-Bit Constant 


Opcode examples are shown of both direct and indirect addressing or of the use 
of short or long immediate operands. 


EXAMPLE Example Instruction EXAMPLE 


Description 


Words 


Cycles | 


Repeatability 


Example 


This section decribes the instruction execution and its effect on the rest‘of the 
processor or memory contents. Any constraints on the operands imposed by the 
processor or the assembler are also described here. The description parallels and 
supplements the information given by the execution block. 


1 


The digit specifies the number of memory words required to store the instruction 
and its extension words. 


Class | (1) 


Instructions are classified according to the number of cycles required for each 
instruction. The single digit value enclosed in parentheses represents the cycle 
execution time of the instruction when not repeated. The instruction is assumed 
to be executed from on-chip ROM and use on-chip RAM. Repeatable multicycle 
instructions will execute in one cycle on all repeat executions. Refer to Appendix 
E for detailed information on instruction cycle timings. 


Category B 


The repeatability of each instruction (using RPT or RPTK) is classified as to A, 
B, C, or X according to the following: 


A Instruction repeatable; useful if repeated. 
B Instruction repeatable; may be of some use if repeated. 
C Instruction repeatable; not useful to repeat the instruction. 
X Instruction not repeatable. 
ADD  ODAT1,3 (DP = 10) 
or 
ADD * 73 If current auxiliary register contains 1281. 
Before Instruction After Instruction 
Data Data 


Memory Memon 


1281 | 
ace ace 
C C 


The sample code presented in the above format shows the effect of the code on 
memory and/or registers. 


ABS _ 


Assembler Syntax 
Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


__Absolute Value of Accumulator _ ___ ABS 


— [<label>] ABS 


None | 


(PC) +17 PC 
\(ACC)| * ACC 


Affects C and OV; affected by OVM. 
Not affected by SXM. _ | 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 
1 1001 1 1 0 00 014 1 0 14 1 


If the contents of the accumulator are greater than or equal to zero, the accu- 


mulator is unchanged by the execution of ABS. If the contents of the accumulator 
is less than zero, the accumulator is replaced by its two’s-complement value. 


Note that >80000000 is a special case. When the overflow mode is not set, the 


~ ABS of >80000000 is >80000000. When in the overflow mode, the ABS of —s 


>80000000 is > 7FFFFFFF. In either case, the OV status bit is set. Also note that 
the carry bit C is always reset to zero by the execution of this instruction. 


1 
Class IV (1) 


Category C 
“ABS 
Before Instruction | After Instruction 
ACC 21234] ~~ acc_ fo] >1234 
aC Cc 
acc SFFFFFFFE acc [9] 
C C 


ADD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Add to Accumulator with Shift ADD 


[<label>] ADD <dma>,[<shift>] 
[<label>] ADD {*|*+]*-|*0+|*0-|*“BRO+|*BRO-}[,<shift>[,<next ARP>]] 


0 < dma s 127 
O < next ARP < 7 
0 < shift < 15 (defaults to 0) 


(PC) +17 PC . 
(ACC) + [(dma) x 2shift] + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 


Then (dma) is not sign-extended. 
Affects C and OV; affected by OVM and SXM. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 14 =O 


0 0 QO QO | Shift = || 0 Data Memory Address 
Oo 0 O QO | Shift =| 1 See Section 4.1 


The contents of the addressed data memory location are left-shifted and added 
to the accumulator. During shifting, low-order bits are zero-filled. High-order 
bits are sign-extended if SXM = 1 and zero-filled if SXM = 0. The result is stored 
in the accumulator. 


1 

Class | (1) 

Category A 

ADD DAT1,3 (DP = 10) 

or 

ADD = 23 If current auxiliary register contains 1281. 

Before Instruction After Instruction 

Data Data 

Memory Memory 
1281 1281 
ACC acc [0] >4 2 

C C 





Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Indirect 


Description — 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] ADDC <dma> — 
[<label>] ADDC {*|*+ |*-| 


O < dma < 127 


O < next ARP < 7 


(PC) +17 PC 


(ACC) + (dma) + (C) ~ ACC 


Affects C and OV: affected by OVM. 


15 14 13 


bit are added to the accumulator. 


manner. 


1 
Class | (1) 
Category B. 


ADDC DAT5 


or 
ADDC. -* 


Data 
Memory 


ACC 


olf 


ADDC DAT5 


or 


ADDC * 


Data 
Memory 
1029 


ACC 


C 


12 11 10 9 


Diect! 0 1 0 0 0 0 1. 1/0 ]- _ Data Memory Address 
1 See Section 4.1 


- The contents of the addressed “data Memory location a nd the vatue of the carty’ OO 
The carry bit is then affected in the normal 





(DP = 8) 


Before Instruction 


> 


(DP = 8) 


Data 
Memory 
1029 


4 


*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


So. 2.4) .0 





The ADDC instruction can be used in performing multiple-precision arithmetic. 


If current auxiliary register contains 1029. 


After Instruction — 


>1 8 


If current auxiliary register contains 1029. 


Before Instruction 


> 


>FFFFFFFF 


a 


Data 
Memory 
1029 


ACC 


C 


After Instruction 


>0 


>0 


ADDH | Add to High Accumulator _ADDH 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


[<label>] ADDH <dma> 
[<label>] ADDH {*|*+|*-|*0+]*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(ACC) + [(dma) x 216] + ACC 


Affects C and OV; affected by OVM. 
Low-order bits of the ACC not affected. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 


O 1 0 oO 1 0 O QO Data Memory Address 


oO 1 0 0 1 0 0 0] 1) See Section 4.1 


The contents of the addressed data memory location are added to the upper half 
of the accumulator (bits 31 through 16). Low-order bits are unaffected by ADDH. 
The carry bit C is set if the result of the addition generates a carry; otherwise, C 


_ is unaffected. The carry bit can only be set, not reset, by the ADDH instruction. 


Words 
Cycles 
Repeatability 


Example 


The ADDH instruction may be used in performing 32-bit arithmetic. 


1 
Class | (1) 
Category B 


ADDH DATS (DP = 8) 
or 


ADDH * If current auxiliary register contains 1029. 
Before Instruction After Instruction 
Data Data 
Memory Memory 
1029 - 1029, 
ACC >1 3 ACC 240013 
C C 


ADDK. 
Assembler Syntax 


Operands. 


Execution 


Encoding 
Description 


Words 


Repeatability 


Example 
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_Add to Accumulator Short Immediate __ mes ADDK 


[<label>] ADDK <constant> 


0 < constant < 255 


(PC) +17 PC 
(ACC) + 8-bit positive constant ~ ACC 


Affects C and OV: affected by OVM. 
Not affected by SXM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 40 


1100 1 10 0]  8-BitConstamt 


The 8-bit immediate value is added, right-justified, to the accumulator with the 
result replacing the accumulator contents. The immediate value is treated as an 
8-bit positive number, regardless of the value of SXM. 


1 
Cae ar ae oe 
Category X 
ADDK >5 
Before Instruction After Instruction 
acc [x] >79B2E1 acc fo] >79B2E6 
C | C 


ADDS Add to Accumulator with Sign-Extension Suppressed ADDS 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ADDS <dma> : 
[<label>] ADDS {*|*+|*-|*0+]*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(ACC) + (dma) ~ ACC 
(dma) is a 16-bit unsigned number. 


Affects C and OV; affected by OVM. 
Not affected by SXM. 


15 14 13 12 11 10 9 6 5 4 3 2 1 9O 


8 7 
O 1 0 O 1 0 O 1 | O- Data Memory Address 
0 1 0 01 0 0 141— See Section 4.1 


The contents of the specified data memory location are added with sign-extension 
suppressed. The data is treated as a 16-bit unsigned number, regardless of SXM. 
The accumulator behaves as a signed number. Note that ADDS produces the 
same results as an ADD instruction with SXM = 0 and a shift count of 0. 


1 
Class | (1) 
Category B 
ADDS DAT11 (DP = 6) 
or 
ADDS * If current auxiliary register contains 779. 
Before Instruction After Instruction 
Data Data 
Memory >FOO6 Memory >FO0O06 
779 779 
Acc acc [9] -F008 
C Cc 





Assembler Syntax a - | | 
Direct. Addressing: [<label>] ADDT <dma> © . . i | 
Indirect Addressing: [<label>] ADDT {*|*+|*-|"0+|"O-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
| O< next ARP <7 


Execution (PC) 24 = PC 
(ACC) + [(dma) x oT register(3-0)} > (ACC) 


lf SXM = 1: - 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by SXM and OVM. 


Encoding 15 14 13 12 11 10 9 8 FJ 6 5 4 3 2 1 = =90 


O 1 0 Ra | See Section 4.1 


Description The data memory value, left-shifted as defined by the four LSBs of the T register, 
is added to the accumulator, with the result replacing the accumulator contents. 
Sign extension on the data memory value is controlled by SXM. 








Indirect 


Words 1 
Cycles | Class | (1) 
Repeatability Category A 
Example ~ ADDT DAT127 (DP = 4) 
or | 
ADDI « If current auxiliary register contains 639. 
Before Instruction After Instruction 
Data Data 
Memory >Q Memory >9 


639 639 


>FF94 >FF94 


-+ 
=| 


ACC >F715 ACC >F7A5 


ole 
o[e] 
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ADLK Add to Accumulator Long Immediate with Shift ADLK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ADLK <constant>[,<shift>] 


16-bit constant 
O < shift < 15 (defaults to 0) 


(PC) +27 PC | 
(ACC) + [constant x 2shift] + ACC 


lf SXM = 1: 
Then -32768 < constant < 32767. 
lf SXM = 0: 


Then O < constant < 65535. 
Affects C and OV; affected by OVM and SXM. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 =O 


1 1 0 1{ Shift [0 0 0 0 0 0 1 0 
16-bit Constant 


The 16-bit immediate value, left-shifted as specified, is added to the accumulator. 
The result replaces the accumulator contents. SXM determines whether the 
constant is treated as a signed two’s-complement number or as an unsigned 
number. The shift count is optional and defaults to zero. 


2 
Class V (2) 
Category X 
ADLK 5,8 
Before Instruction After Instruction 
ACC >10EF acc _[o] >15EF 
C C 
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| Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 


Repeatability 


Example 


4-24 


[<label>] ADRK <constant> ~ 


O< constant < 255 


(PC) +17 PC 
AR(ARP) + 8-bit positive constant > AR(ARP) 


15 14 13 12 11 10 9Q 8 7 6 65 4 3 2 1 O 





8-Bit Constant 


The 8-bit immediate value is added, right-justified, to the currently selected 
auxiliary register with the result replacing the auxiliary register contents. The 
addition takes place in the ARAU, with the immediate value treated as an 8-bit — 
positive integer. | 


1 
Class IV (1) 


ADRK >80 (ARP = 5) 


Before Instruction — —_ After Instruction 


AR5 |  . 24321 ARS >43A1 





AND 
Assembler Syntax 


Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


AND with Accumulator | | AND 


[<label>] AND <dma> 
[<label>] AND {*|*+]*-]"0+[*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(ACC(15-0)).AND.(dma) ~ ACC(15-0) 
0 + ACC(31-16) 


Not affected by SXM. 
15 14 13 12 11 10 9 6 5 4 3 2 1 QO 


8 7 
Oo 1 0 0 1 1 +1 «Of O| Data Memory Address 
0 1 0 0 14 4 #14 9 eae See Section 4.1 


The lower half of the accumulator is ANDed with the contents of the addressed 
data memory location. The upper half of the accumulator is ANDed with all zeroes. 
Therefore, the upper half of the accumulator is always zeroed by the AND 
instruction. 


1 


Class | (1) 
Category B 
AND DAT16 (DP = 4) 
or 
AND * If current auxiliary register contains 528. 
Before Instruction After Instruction 
Data Data 
Memory >F F Memory >F F 
528 528 
ACC >12345678 ACC >00000078 
Cc C 


ANDK 


Assembler Syntax | 


| | Operands 


Execution 


Encoding 
Description 


Words 
Cycles 
Repeatability 


Example 
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AND Immediate with Accumulator with Shift — ANDK 


[<label>] ANDK er eee 


16-bit constant : 


O < shift < 15 rastauits: to 0) 
(PC) +2-> PC 


(ACC(30-0)).AND.[(constant x 28hifty] + ACC(30-0) | 
0 ~ ACC(31) and all other bit positions not occupied by the shifted constant. 


Not affected by SXM. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 14 +0 


110 1] snk [0 





- © | 16-bit Constant oe , 


The 16-bit immediate constant is left-shifted as specified and ANDed with the 
accumulator. The result is left in the accumulator. Low-order bits below and 
_ high-order bits above the shifted value are treated as zeroes, clearing the corre- =| 
sponding bits in the accumulator. Note that the accumulator’s most-significant 
bit is always zeroed regardless of the shift-code value. 


2 
Class V (2) 
Category X 
ANDK >FFFF ,12 
_ Before Instruction After Instruction 
ACC >12345678 ACC >02345000 
Cc - C 


APAC Add P Register to Accumulator. ; APAC 


Assembier Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] APAC 


None 
(PC) +17 PC 
(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
Not affected by SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 = =0 
1 1 0 0 4 14 174 0 0 0 0 14 O 14 0 


— \ 


The contents of the P register are shifted as defined by the PM status bits and 
added to the contents of the accumulator. The result is left in the accumulator. 
APAC is not affected by the SXM bit of the status register; the P register is always 
sign-extended. Note that APAC is a subset of the LTA, LTD, MAC, MACD, MPYA, 
and SORA instructions. 


1 


Class IV (1) 
Category B 
APAC (PM = 0) 
Before Instruction After Instruction 
ACC >20 acc [0] >6 0 
C | C 
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Assembler Syntax [<label>] B <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


Operands O < pma <s 65535 
| 0 < next ARP < 7 


Execution | pma ~ PC a a ae 
Modify AR(ARP) and ARP as specified. 


Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


1 1 1 1 1 1 1 1 1] See Section 4.1 
| Program Memory Address | 


Description The current auxiliary register and ARP are modified as specified, and control 
passes to the designated program memory address (pma). Note that no AR or 
ARP modification occurs if nothing is specified in those fields. Pma can be either 
a symbolic or a numeric address. | 


Words 2 

Repeatability Category X 

Example B PRG191 191 is loaded into the program counter, and 
the program continues running from that 
location. ? : 
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BACC Branch to Address Specified by Accumulator BACC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BACC 
None 
(ACC(15-0)) > PC 


15 14 13 12 11 10 9Q 
1 41 0 0 1 1 1 


The branch uses the lower half of the accumulator (bits 15-0) for the branch 


address. 


1 
Class VIII (3) 
Category X 


BACC 


Before Instruction 


PC >16E4 
ACC >F7FF9545 


C 


PC 


ACC 


C 


After Instruction 
>9545 


>F7FF9545 
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Assembler Syntax 


Operands 


Execution 
Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 
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[<label>] BANZ <pma> [,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma <s 65535 
O < next ARP <7 


If AR(ARP) # 0: 

Then pma ~ PC; 

Else (PC) +27 PC. | 
Modify AR(ARP) as specified. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 O 


1 1 1 1 1 0 1 1 1 See Section 4.1 
Program Memory Address | i. | | 


Control is passed to the designated program memory address (pma) if the current 
auxiliary register is not equal to zero. Otherwise, control passes to the next 


instruction. The current auxiliary register and ARP are also modified as specified. = 


The current auxiliary register is either incremented or decremented from zero when 


the branch is not taken. Note that the AR modification defaults to *- (decrement 
current AR by one) when nothing is specified, making it compatible with the 


~TMS32010. Pma can be either a symbolic or a numeric address. 


2 

Class VII (3) 
Category X 

BANZ PRG35,*- 

- | Before Instruction After Instruction 
AR AR 
PC >46 PC >35 

or 
AR AR SFFFE 
PC >46 PC >48 
BANZ PRGO4, *+ 
Before Instruction After Instruction 
AR SFFFE] AR 
PC Pc 64 
or 
po Po 


BANZ Branch on Auxiliary Register Not Zero BANZ 


Note: 


BANZ is designed for loop control using the auxiliary registers as loop coun- 
ters. Using *0+ or *0- allows modification of the loop counter by a variable 


step size. Care must be exercised when doing this, however, because the 
auxiliary registers behave as modulo 65536 counters, and zero may be passed 
without being detected if ARO > 1. 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


aoe 


[<label>] BBNZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP <s 7 


if test/control (TC) Status bit = 1: 
Then pma > PC; 
Else (PC) +2 > PC. 
Modify AR (ARP) and ARP as specified. 


Affected by TC. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 «0 


4 «4 4 4 4 OlUOOUUTlC See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if TC = 1. Otherwise, control 


~ ‘passes to the next instruction. Note that no AR or ARP modification occurs if 


nothing is specified in those fields. Pma can be either a symbolic or a numeric 
address. Note that the TC bit may be affected by the BIT, BITT, CMPR, LST1, 
NORM, RTC, and STC instructions. 


2 

Class VII (3) 

Category X 

BBNZ PRG650 If TC = 1, 650 is loaded into the program 


counter; otherwise, the program counter 
is incremented by 2. 


BBZ Branch on Bit Equal to Zero ae BBZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BBZ <pma>[,{"|*+|*-|*0+]*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 
O < next ARP < 7 


If test/control (TC) status bit = 0: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Affected by TC bit. 
15 14 13 12 11 10 9 8 7F 6 5 4 3 2 1 0 


1 1 1 1 1 0 O OQ 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if TC = 0. Otherwise, control 
passes to the next instruction. No AR or ARP modification occurs if nothing is 
specified in those fields. Pma can be either a symbolic or a numeric address. 
Note that the TC bit is affected by the BIT, BITT, CMPR, LST1, NORM, RTC, and 
STC instructions. 


2 

Class VII (3) 

Category X 

BBZ PRG325 If TC = 0, 325 is loaded into the program 


counter; otherwise, the program counter 
1s incremented by 2. 
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BC _ | Branch on Carry i BC 


Assembler Syntax [<label>] BC <pma>[,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


Operands 0 < pma < 65535 
O < next ARP s 7 


Execution If carry bit C = 1: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


- Affected by C. | 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 = =9O 


0 1 OO 1 1 1 1 0 1 - See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 


__ passes to the designated program memory address if the carry bit C = 1..Other- 


wise, control passes to the next instruction. Note that no AR or ARP modification 
occurs if nothing is specified in those fields. Pma can be either a symbolic or a 
numeric address. 


Note that the carry bit C is affected by all add, subtract, and accumulate 
instructions as well as the ABS, LST1, NEG, RC, SC, rotate, and shift instructions. 
The carry bit is not affected by execution of BC, BNC, or nonarithmetic 
instructions. 


Words 2 

Cycles Class VII (3) 

Repeatability Category X 

Example BC PRG512 If the carry bit C = 1, 512 is loaded into 


the program counter; otherwise, the program 
counter iS incremented by 2. 
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BGEZ Branch if Accumulator Greater Than or Equal to Zero  BGEZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] BGEZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]]- 


O < pma < 65535 
O < next ARP < 7 


If (ACC) > 0: 

Then pma > PC; 

Else (PC) + 2 > PC. | 
Modify AR (ARP) and ARP as specified. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 .1 0 


1 1 1 1 O 1 0 O 1 | See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are greater than or equal to zero. Otherwise, control passes to the next 
instruction. Note that no AR or ARP modification occurs if nothing is specified 
in those fields. Pma can be either a symbolic or a numeric address. 


2 

Class Vil (3) 

Category X 

BGEZ PRG217 217 is loaded. into the program counter if 
the accumulator is greater than or equal 
to zero. 
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BGZ Branch if Accumulator Greater Than Zero _ BGZ 


Assembler Syntax [<label>] BGZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] _ 


Operands O < pma < 65535 
7 0 < next ARP < 7 
Execution lf (ACC) > 0: 


Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. - 


Encoding 15 14 13 12 11 10 9 8 j7F7 6 5 4 3 2 1 0 


18114 14 0 00 1 1 See Section 4.1 
| | Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- | 
mulator are greater than zero. Otherwise, contro! passes to the next instruction. 


_ Note that no AR or ARP modification occurs if nothing is specified in those fields. 


~ Pma can be either a symbolic or a numeric address. 


Words 2 

Cycles Class Vil (3) 

Repeatability Category X 

Example BGZ PRG342 342 is loaded into the program counter if 


the accumulator is greater than zero. 
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BIOZ Branch on I/O Status Equal to Zero 3 BIOZ 


Assembler Syntax —[<label>] _BIOZ <pma>[,{*|"+|*-|"0+|*0-|"BRO+|*BRO-}[,<next ARP>]] 


Operands O < pma s 65535 
O < next ARP < 7 


Execution lf BIO = 0: 
Then pma ~ PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 


1 1 1 1 1 O 1 O 1 See Section 4.1 
Program Memory Address 


Description The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the BIO pin is low. Other- 
wise, control passes to the next instruction. Note that no AR or ARP modification 
occurs if nothing is specified in those fields. Pma can be either a symbolic or a 
numeric address. 


BIOZ in conjunction with the BIO pin can be used to test if a peripheral is ready 
to send or receive data. Polling the BIO pin using BIOZ may be preferable to an 
interrupt when executing time-critical loops. 


Words 2 

Cycles Class VII (3) 

Repeatability Category X 

Example BIOZ PRG64 If the BIO- pin is active (low), then 


a branch to location 64 occurs. 
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BIT. 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Test Bit oe | | BIT 


[<label>] BIT <dma>,<bit code> a 

[<label>] BIT {*|*+]*-|*0+|*0-|"BRO+|*BRO-},<bit code>[,<next ARP>] 
0 < dma < 127 

O < ARP <7 

O < bit code < 15 


(PC) +1 7 PC 
(dma bit at bit address (15-bit code)) ~ TC. 


Affects TC. 
15 14 13 12 1110 9 8 65 43 21 «0 


Direct [1001] BitCode | 0] Data Memory Address 


Indirect 


70.0 1] Bode] 7 See Section 4.1 


The BIT instruction copies the specified bit of the data memory value to the TC 


bit of status register ST1. Note that the BITT, CMPR, LST1, and NORM 
instructions also affect the TC bit in status register ST1. A bit code value is 
specified that corresponds to a certain bit address in the instruction, as given by 
the following table: 


Bit Code 
Bit Address 1110 9 8 
(LSB) 0 1111 
1 1110 
2 1101 
3 1100 
4 1011 
5 1010 
6 100 1 
7 1000 
8 0111 
9 0110 
10 0101 
11 0100 
12 0011 
13 001.0 
14 0001 
(MSB) 15 0000 
1 
Class | (1) 
Category C 
BIT >0,>8 (DP = 488) 
or 
BIT = 3 If current auxiliary register contains >F400. 
Before Instruction After Instruction 
Data Data 
Memory >7 E98 Memory >7 E98 
>F400 >F400 


Te re 


BITT Test Bit Specified by T Register | BITT 


Assembler Syntax 
Direct Addressing: [<label>] BITT <dma> 
Indirect Addressing: [<label>] BITT {*|*+]|*-|*0+[*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PC) +1 7PC 
(dma bit at bit address (15-T register(3-0))) ~ TC 
Affects TC. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 14 0 


Direct 0 1 QO 1 0 1 1 LO. Data Memory Address 
0 1 0 1 01 4 #141) See Section 4.1 


Description The BITT instruction copies the specified bit of the data memory value to the TC 
bit of status register ST1. Note that the BIT, CMPR, LST1, and NORM instructions 
also affect the TC bit in status register ST1. The bit address is specified by a bit 
code value contained in the LSBs of the T register, as given in the following table: 


Indirect 








Bit Code 
Bit Address 3210 
(LSB) 0 111 1 
1 1110 
2 110 1 
3 1100 
4 101 1 
5 1010 
6 100 1 
7 1000 
8 0111 
9 0110 
10 0101 
11 0100 
12 001 1 
13 001 0 
14 000 1 
(MSB) 15 0000 
Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example BITT >0 Value in T register points to bit 14 of 
| data word (DP = 240). 
or 
BITT - If current auxiliary register contains >7800. 
Before Instruction After Instruction 
Data Data 
Memory >4DC8 Memory >4DC8 
— >7800 >7800 
rr rr 
TC te 
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Assembler Syntax 


Operands 
Execution 


Encoding 


Description 


Words 
Cycles | 
Repeatability 


Example 


4-40 


[<label>] BLEZ <pma>[,{*|*+|*-|*0+]|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma < 65535 | 


O < next ARP < 7 


If (ACC) < 0: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. | 


15 14 13 12 1110 9 8 7°6 5 4 3 2 1 «0 


117 171 007 079 See Section 4.1 
| _ Program Memory Address. 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are less than or equal to zero. Otherwise, control passes to the next 
instruction. Note that no AR or ARP modification occurs if nothing is specified — 





~ in those fields. Pma can be either a symbolic or a numeric address. | 


2 
Class VII (3) 
Category X 


BLEZ PRG63 63 is loaded into the program counter if the 
accumulator is less than or equal to zero. 


BLKD Block Move from Data Memory to Data Memory BLKD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Direct 


Indirect 


[<label>] BLKD <dma1>,<dma2> 
[<label>] BLKD <dmai>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 65535 
0 < dma2 < 127 
0 < next ARP < 7 


(PC) +27 PC 
(PFC) ~ MCS 
(dma1) ~ PFC 


While (repeat counter) # 0: 
(dma1, addressed by PFC) ~ dma2, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 > PFC, 
(repeat counter) - 1 > repeat counter. 


(dmat, addressed by PFC) ~ dma2 
Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 9 


1 1 1 1 1 1 0 1] 0 | Data Memory Address 2 


Data Memory Address 1 


a a a ee ee See Section 4.1 
Data Memory Address 1 | | 


Consecutive memory words are moved from a source data memory block to a 
destination data memory block. The starting address (lowest) of the source block 
is defined by the second word of the instruction. The starting address of the 
destination block is defined by either the dma contained in the opcode (for direct 
addressing) or the current AR (for indirect addressing). In the indirect addressing 
mode, both the current AR and ARP may be modified in the usual manner. In the 
direct addressing mode, dma2 is used as the destination address for the block 
move but is not modified upon repeated executions of the instruction. Thus, the 
contents of memory at the dma2 address will be the same as the contents of 
memory at the last dma address in a repeat sequence. . 






RPT or RPTK must be used with this instruction, in the indirect addressing mode, 
if more than one word is to be moved. The number of words to be moved is one 
greater than the number contained in the repeat counter RPTC at the beginning 
of the instruction. At the end of this instruction, the RPTC contains zero and, if 
using indirect addressing, AR(ARP) will be modified to contain the address after 
the end of the destination block. Note that the source and destination blocks do 
NOT have to be entirely on-chip or off-chip. However, BLKD cannot be used to 
transfer data from a memory-mapped register to any other location in data 
memory. 


The PC points to the instruction following BLKD after execution. Interrupts are 
inhibited during a BLKD operation used with RPT or RPTK. 


2 
Class XIll (4) 
Category A 
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Example - RPTK | ae 
BLKD >F400,*+ If current auxiliary register contains 1030. 


dmal 


Data 
Memory 
62464 


Data 
Memory 
62465 


Data 


_..Memory. _ 


— 62466 


dma2 


Data 


Memory 
1030 


Data — 


Memory 
1031 


Data 
Memory 
1032 
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Before Instruction 


>7F98 


| >FFE6 | 





Before Instruction 


“ies SBDEE] 


>9315 


3 >2531 


_ Data 
~Memory | 
— 62464 - 


Data 
Memory 
62465 


Data 


62466 


Data 
Memory 
1030 


Data 
Memory 
1031 


Data 
Memory 
1032 


After Instruction 


>7F98. 


>FFE6 





After Instruction 


>7F98 
>FFE6 


>9522 


BLKP Block Move from Program Memory to Data Memory BLKP 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Direct 


Indirect 


[<label>] BLKP <pma>,<dma> 
[<label>] BLKP <pma>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < pma s 65535 
O < dma < 127 
O < next ARP < 7 


(PC) +27 PC 
(PFC) ~ MCS 
(pma) ~ PFC 


While (repeat counter) # 0: 
(pma, addressed by PFC) ~ dma, 
Modify AR(ARP) and ARP as specified, 
(PFC) +1 > PFC, 
(repeat counter) - 1 ~ repeat counter. 


(pma, addressed by PFC) ~ dma 
Modify AR(ARP) and ARP as specified. 
(MCS) > PFC 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 


1 1 1 1 1 1 0 O 0 | Data Memory Address 
Program Memory Address 


1 1 14 14 14 1 +0 Of 1) See Section 4.1 
Program Memory Address 


Consecutive memory words are moved from a source program memory block to 
a destination data memory block. The starting address (lowest) of the source 
block is defined by the second word of the instruction. The starting address of 
the destination block is defined by either the dma contained in the opcode (for 
direct addressing) or the current AR (for indirect addressing). In the indirect 
addressing mode, both the ARP and the current AR may be modified in the usual 
manner. In the direct addressing mode, dma is used as the destination address for 
the block move but is not modified by repeated executions of the instruction. 
Thus, the contents of memory at the dma address will be the same as the contents 
of memory at the last pma address in a repeat sequence. 


RPT or RPTK must be used with this instruction if more than one word is to be 
moved. The number of words to be moved is one greater than the number 
contained in the repeat counter RPTC at the beginning of the instruction. At the 
end of this instruction, the RPTC contains zero and, if using indirect addressing, 
AR(ARP) will be modified to contain the address after the end of the destination 
block. Note that source and destination blocks do NOT have to be entirely on-chip 
or off-chip. 


The PC points to the instruction following BLKP after execution. Interrupts are 
inhibited during a BLKP operation. 


If the MP/MC pin is low at the time of execution of this instruction and the — 
program memory address used is less than 4096, an on-chip ROM location will 
be read. | 


2 
Class XIV (4) 
Category A 





Example | RPTK 2 = | | oo ts, 
| BLKP 65120,*+ If current auxiliary register contains 2048. 








pma | 
Before Instruction ae ae After Instruction 
Program Program 
Memory >A089Y9 ~ Memory — >A089 
65120 65120 © 
Program Program 
Memory Memory >2DCE 
65121 65121 | 
Program Program 
_ Memory Memory |... | 
65122 65122 
dma 
Before Instruction After Instruction 
Data Data 
Memory >1234 _ Memory >A089 
2048 2048 © 


2049 — 2049 


Data Data 
Memory >2005 Memory >2 DCE 


Data | | Data — 
Memory >EQ9S8C Memory >S AQF 


2050 2050 
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BLZ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Branch if Accumulator Less Than Zero | BLZ 


[<label>] BLZ <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 
O < next ARP < 7 


If (ACC) < 0: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


15 14 13 12 11 10 9 8 F7 6 5 4 3 2 = 1 0 


1 1 1 1 0 Oo 1 1 1 See Section 4.1 | 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are less than zero. Otherwise, control passes to the next instruction. Note 
that no AR or ARP modification occurs when nothing is specified in those fields 
Pma can be either a symbolic or a numeric address. 


2 
Class VII (3) 
Category X 


BLZ PRG481 481 is loaded into the program counter if the 
accumulator is less than zero. 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-46 


[<label>] BNC <pma>[,{*|"+|*-|"0+|*"0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 


0 < next ARP < 7 


If carry bit C = 0: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Affected by C. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «9 


Oo 1 014 4 4 4 +4 ° 44. See Section 4.1 
| Program Memory Address | 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the carry bit C = 0. Other- 


wise, Control passes to the next instruction. Note that no AR or ARP modification 


occurs when nothing is specified in those fields. Pma can be either a symbolic 
Or a numeric address. | 


Note that the carry bit C is affected by all add, subtract, and accumulate 
instructions as well as the ABS, LST1, NEG, RC, SC, rotate, and shift instructions. 
The carry bit is not affected by execution of the BC, BNC, or nonarithmetic 
instructions. 


2 
Class VII (3) 
Category X 


BNC PRG325 If the carry bit C = 0, 325 is loaded into 
the program counter. Otherwise, the program 
counter is incremented by 2. 


BNV 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Branch if No Overflow BNV 


[<label>] BNV <pma>[,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>]] 


O < pma s 65535 
0 < next ARP < 7 


If overflow OV status bit = 0: 

Then pma > PC; 

Else (PC) + 2 ~ PC and 0 > OV. 
Modify AR(ARP) and ARP as specified. 


Affects OV; affected by OV. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 #1 = 90 


1 1 1 1 0 1 1 1 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program address if the OV (overflow flag) is clear. 
Otherwise, the OV is cleared, and control passes to the next instruction. Note that 
no AR or ARP modification occurs if nothing is specified in those fields. Pma 
can be either a symbolic or a numeric address. 


2 

Class Vil (3) 

Category X 

BNV PRG315 315 is loaded into the program counter if 


the overflow flag is clear. OV is cleared. 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-48 


[<label>] BNZ. <pma>[,{*|*+|*-|"0+]"0-|*BRO+|*BRO-}[,<next ARP>]] — 


0 < pma < 65535 


O < next ARP < 7 


If (ACC) # 0: 
Then pma ~ PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as epee iedt: 


15 14 13 12 11 10 9 8.7.6 5 4 3 2 1 «0 





The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are not equal to zero. Otherwise, control passes to the next instruction. 
Note that no AR or ARP modification occurs if nothing is specified i in those fields. 


~-Pme-can-be either a symbotic ora numeric. address.” 


2 

Class VII (3) 

Category X 

BNZ PRG320 320 is loaded into the program counter if | 


the accumulator does not equal zero. 


BV 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


.... Branch on Overflow _ BV 


[<label>] BV <pma>[,{*|"+|*-|*0+|*0-|"*BRO+|*BRO-}[,<next ARP>]] 


O < pma s 65535 
O < next ARP < 7 


If overflow (OV) status bit = 1: 
Then pma ~ PC and O > OV; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


Affects OV; affected by OV. 
15 14 13 12 11 10 9 8 7F7 6 5 4 3 2 =°1 0 


1 1 1 1 0 0 0 0 1 See Section 4.1 
Program Memory Address 


The current auxiliary register and ARP are modified as specified, and the overflow 
flag is cleared. Control passes to the designated program memory address if the 
OV (overflow flag) is set. Otherwise, control passes to the next instruction. Note 
that no AR or ARP modification occurs if nothing is specified in those fields. Pma 
can be either a symbolic or a numeric address. 


2 

Class VII (3) 

Category X 

BV PRG610 If an overflow has occurred since the over- 


flow flag was last cleared, then 610 is 
loaded in the program counter. 
OV is cleared. 
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Assembler Syntax | 


Operands 


Execution | 


Encoding 


Description | 


Words 
Cycles 
Repeatability 


Example 
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[<label>] BZ <pma>[{*|*+|*-|"0+|"0-|*BRO+|*BRO-}[,<next ARP>]] 


0 < pma < 65535 


0 < next ARP <7 


If (ACC) = 0: 
Then pma > PC; 
Else (PC) + 2 > PC. 
Modify AR(ARP) and ARP as specified. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


1177 17 097 7 0 9; See Section 4.1 
: Program Memory Address_. 


The current auxiliary register and ARP are modified as specified. Control then 
passes to the designated program memory address if the contents of the accu- 
mulator are equal to zero. Otherwise, control passes to the next instruction. Note 


that no AR or ARP modification occurs if nothing is specified in those fields. Pma 
Gan be either a symbolic or a numeric address. 


2 
Class VII (3) 
Category X 


BZ PRG102 102 is loaded into the program counter if 
the accumulator is equal to zero. 


CALA 
Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Call Subroutine Indirect CALA 


[<label>] CALA 


None 


(PC) + 1-7 TOS 
(ACC(15-0)) > PC 


15 14 13 12 11 10 9 8 7F 6 5 4 3 2 1 = «0 
1 1 0 0 1 1 1 0 0 0 14 0 0 14 OO 0 


The current program counter is incremented and pushed onto the top of the stack. 
Then, the contents of the lower half of the accumulator are loaded into the PC. 
The carry bit is unaffected by this instruction. 


The CALA instruction is used to perform computed subroutine calls. 


1 
Class VIII (3) 
Category X 
CALA 
Before Instruction After Instruction 
ACC >8 3 ACC >8 3 
STACK STACK 
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CALL 


Assembler Syntax 


Operands | 


Execution 


Encoding 


Description 


Cycles 
Repeatability 


Example 
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___Call Subroutine _CALL 


[<label>] CALL <pma>[,{*|*+|*-|*0+|"0-|*BRO+|*BRO-}[,<next ARP>]] 
0s pma < 65535 : 


O < next ARP < 7 


(PC) +2 > TOS 
pma ~ PC | 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #90 





1 1 1 1 1 1 1 0 1] See Section 4.1 
| | Program Memory Address 





— The current auxiliary register and ARP are modified as specified, and the PC 


(program counter) is incremented by two and pushed onto the top of the stack. 
The specified program memory address is then loaded into the PC. Note that no 
AR or ARP modification occurs if nothing is specified in those fields. Pma can 
be either a symbolic or a numeric address. 


Class VIII (3) 


Category X 
CALL PRG109 


Before Instruction After Instruction 


STACK STACK 





CMPL | Complement Accumulator CMPL 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] CMPL 


None 


(PC) +1 PC 
(ACC) > ACC 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 
1 1 0 0 14 4 41 0 O08 O 41 OF O 1 1 1 


The contents of the accumulator are replaced with its logical inversion (one’s 
complement). 


1 


Class IV (1) 
Category C 
CMPL 
Before Instruction After Instruction 
ACC >F7982513 ACC >0867DAEC 
Cc C 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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[<label>] CMPR <CM> 


0<CM <3 


(PC) +17 PC 
Compare AR(ARP) to ARO, placing result in TC bit a status register ST1. 


Affects TC. 
Not affected by SXM; does not affect SXM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


1 1-0 01 14 14 0 0 1 0 1 0 Of CM | 


The CMPR instruction performs the following comparisons dependent on | the 
value of CM: 


If CM = OO, test if AR(ARP) = ARO 

If CM = 01, test if AR(ARP) < ARO 

If CM = 10, testif AR(ARP) > ARO. 
Tf CM = 11, test if AR(ARP) « ARO 


lf the result of a test is true, a one is loaded into the TC status bit. Otherwise, 
TC is loaded with a zero. The auxiliary registers are treated as unsigned integers 
in the comparison. 


1 

Class IV (1) 

Category C 

CMPR 2 (ARP = 4) 

Before Instruction After Instruction 

ARO >FFFF ARO >FFFFE 
AR4 >7 FFF AR4 >7 FFF 
TC TC 


CNFD Configure Block as Data Memory CNFED 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] CNFD 


None 


(PC) +17 PC 
0 ~ RAM configuration control (CNF) status bit 


Affects CNF. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 
1 1 0014 1 4 0 0 0 0 0 0 1 0 0 


On-chip RAM block 0 is configured as data memory. The block is mapped to 
locations 512 through 767 in data memory. This instruction is the complement 
of the CNFP instruction and sets the CNF bit in status register ST1 to a zero. 
CNF is also loaded by the CNFP and LST1 instructions. 


The next two instruction fetches immediately following a CNFD or CNFP 
instruction use the old value of CNF. 

1 

Class IV (1) 

Category C 


CNFD A zero is loaded into the CNF status bit, thus 
configuring block BO as data memory (see 
memory maps in Section 3.2). 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description — 


Words 
Cycles 
Repeatability 


Example 
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[<label>] CNFP 

None | | 

(PC) +17 PC | 
1 7-7 RAM configuration control (CNF) status bit - 
Affects CNF. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 =«0 
1414 001 14 41 00 0 00 01 0 1 


On-chip RAM block 0 is configured as program memory. The block is mapped 
to locations 65280 through 65535 in program memory space. This instruction 
is the complement of the CNFD instruction and sets the CNF bit in status register 
ST1 to a one. CNEF is also loaded by the CNFD and LST1 instruction. 


Configuring this block as program memory allows the use of the program counter 


. @s-an-address-generaterto-access-_data_trom-on-chip RAM — 


with the repeat instructions, this allows two data memory locations to be 
addressed simultaneously, one from the auxiliary registers and one from the 
program counter. Instructions that take advantage of this feature are the MAC, 
MACD, BLKD, and BLKP instructions. 


The next two instruction fetches immediately following a CNFD or CNFP 
instruction use the old value of CNF. 


1 | 
Class IV (1) 
Category C 


CNFP The CNF bit is set to a logic 1, thus config- 
uring block BO as program memory (See memory 
maps in Section 3.2) 


DINT Disable Interrupt DINT 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] DINT 


None 


(PC) +1 7 PC 
1 > interrupt mode (INTM) status bit 


Affects INTM. 


15 14 13 12 11 10 9 8 F 6 5 4 3 2 1 =O 
1 1 0 0 1 1 1 0 0 0 0 0 0 0 90 1 


The interrupt mode (INTM) status bit is set to logic 1. Maskable interrupts are 
disabled immediately after the DINT instruction executes. Note that the LST 
instruction does not affect INTM. 


The unmaskable interrupt, RS, is not disabled by this instruction, and the interrupt 
mask register (IMR) is unaffected. Interrupts are also disabled by a reset. 

1 

Class IV (1) 

Category C 


DINT Maskable interrupts are disabled, and INTM is 
Sect’ CO one. 
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DMOV__ ____Data Move in Data Memory | __DMOV 


Assembler Syntax | 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description  _. 


Words 
Cycles 
Repeatability 


Example 
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[<label>] DMOV <dma> | 
[<label>] _DMOV {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(dma) ~ dma + 1 


Affected by CNF. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 


0 1 0 1 0 1 14 Of 0. Data Memory Address 


0 See Section 4.1 





The contents of the specified data memory address are copied into the-contents 


of the next higher address. DMOV works only within the on-chip data RAM 
blocks BO, B1, and B2. It works within block BO if it is configured as data memory, 
and the data move function is continuous across the boundaries of blocks BO and 
B1; ie., it works for locations 512 to 1023. The data move function cannot be 
used on external data memory. If used on external data memory or memory- 
mapped registers, DMOV will read the specified memory location but will perform 
no other operations. 


When data is copied from the addressed location to the next higher location, the 
contents of the addressed location remain unaltered. 


The data move function is useful in implementing the z~! delay encountered in 
digital signal processing. The DMOV function is included in the LTD and MACD 
instructions (see the LTD and MACD instructions for more information). 


1 
Class | (1) 
Category A 


DMOV DAT8 
or 


DMOV * If current auxiliary register contains 520. 
Before Instruction After Instruction 
Data Data , 
Memory >4 3 Memory >43 
520 520 
Data Data 
Memory Memory 43 
521 521 


EINT Enable Interrupt —__ EINT 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] EINT 


None 


(PC) +17 PC 
O > interrupt-mode (INTM) status bit 


Affects INTM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
1 1 0 0 1 1 1 0 0 0 0 0 0 0 90 0 


The interrupt-mode flag (INTM) in the status register is cleared to logic 0. 
Maskable interrupts are enabled after the instruction following EINT executes. 
This allows an interrupt service routine to re-enable interrupts and execute a RET 
instruction before any other pending interrupts are processed. Note that the LST 
instruction does not affect INTM. (See the DINT instruction for further informa- 
tion.) 


1 
Class IV (1) 
Category C 


EINT Unmasked interrupts are enabled, and INTM is 
set to zero. 
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FORT __ Format Serial Port Registers —__—__ FORT 


Assembler Syntax [<label>] FORT [<constant>] | 


Operands | | Constant = 0 or 1 
Execution (PC)+17>PC 
Constant ~ format (FQ) status bit 
Affects FO. 
Encoding | 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #90 


1 1°00 1 1 14 0 0 0 0 0 1 +1 =«4174 FO 


Description | The format (FO) status bit is loaded by the instruction with the LSB specified in 
the instruction. The FO bit is used to control the formatting of the transmit and 
receive shift registers of the serial port. If FO = 0, the registers are configured to 
receive/transmit 16-bit words. If FO = 1, the registers are configured to 
receive/transmit 8-bit bytes. FO is set to zero on a reset. 


MOE oo a ren a er eck a ce hserte stern ne en de eae es nee ecg np Re See enema gee 
Cycles Class IV (1) 
Repeatability Category C 
Example FORT 1 The FO status bit is loaded with 1, making 


the bit length of the serial port 8 bits. 
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IDLE Idle Until Interrupt | IDLE 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] IDLE 


None 


(PC) 1. PC 
O > interrupt mode (INTM) status bit 


Affects INTM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 
1 1 0 0714 17 1 0 0 0 0% 47 1 1 4 


The IDLE instruction forces the program being executed to wait until an interrupt 
or reset occurs. The PC is incremented only once, and the device remains in an 
idle state until interrupted. Note that INTM is set to zero in order for the maskable 
interrupts to be recognized. Execution of the IDLE instruction causes the device 
to enter the powerdown mode (see Section 3.4.6). 


1 
Class XV (3) 
Category X 


IDLE The processor idles until a reset or unmasked 
interrupt occurs. 
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Assembler Syntax OT | | 
Direct Addressing: [<label>] IN <dma>,<PA> / 
Indirect Addressing: pslaver? 4 IN © : nr |"O+|*0-|*BRO+|*BRO-},<PA>[,<next ARP>] 


Operands | 0 < dma < 127 
| O < next ARP < 7 
O < port address PA < 15 


Execution (PC) +17 PC 
Port address ~ address bus A3-A0 
O ~ address bus A15-A4 
Data bus D15-D0O ~ dma 


Encoding © 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 9 
Direct Port Data Memory Address 
Address 


Indirect{ 1.0 0 O[ Port 





“Address 


Description The IN instruction reads a 16-bit value from one of the external I/O ports into the 
3 specified data memory location. The IS line goes low to indicate an |/O access, 
and the STRB, R/W, and READY timings are the same as for an external data 


memory read. 
Words 1 
Cycles Class IX (2) 
Repeatability Category A 
Example IN STAT, PAS Read in word from peripheral on port 
address 5. Store in data memory 
location STAT. 
or 
LRLK 1,520 Load AR1 with decimal 520. 
LARP 1 Load ARP with decimal 520. 
IN *-,PA1,0 Read in word from peripheral on port 


address 1. Store in data memory. 
location 520. Decrement AR1 to 519. 
Load the ARP with 0. 
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LAC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Load Accumulator with Shift LA 


[<label>] LAC <dma>,[<shift>] 
[<label>] LAC {*|*+|*-|*0+|*0-|*“BRO+|*BRO-}(, <shift>L <next ARP>}] 


O < dma <s 127 
O < next ARP < 7 
0 < shift < 15 (defaults to 0) 


(PC) +17PC 
(dma) x 28hift + ACC 


If SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 


Then (dma) is not sign-extended. 
Affected by SXM. 
15 14 13 12 11 10 9 8 7F7 6 5 4 3 2 1 #=@O 


Direct |_O 0 1 Of Shift Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Oo 0 1 O| Shit | 1 See Section 4.1 


The contents of the specified data memory address are left-shifted and loaded into 
the accumulator. During shifting, low-order bits are zero-filled. High-order bits 
are sign-extended if SXM = 1 and zeroed if SXM = 0. 


1 


Class | (1) 

Category C 

LAC DAT6 , 4 (DP = 8) 

or 

LAC *,4 If current auxiliary register contains 1030. 

Before Instruction After Instruction 
Data Data 
Memory Memory 

1030 1030 


Acc ace fl 10 
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LACK 


Assembler Syntax 


Operands | 


Execution 


Encoding 


Description - 


Words 
Cycles 


Repeatability | 


Example 
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7 2 Load Accumulator Immediate Short _———————s—Ss LACK 


_[<label>] LACK <constant> 


| 0 < constant < 255 


(PC) +17 PC 
8-bit positive constant ~ ACC 


Not affected by SXM. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 = 90 


oa 0 0 41 Ot Of} 8Bit Constant 


The 8-bit constant is loaded into the accumulator right-justified. The upper 24 
bits of the accumulator are zeroed (i.e., sign extension is suppressed). 


1 
Class IV (1) 


Category X | | 


LACK >15 


| : Before Instruction After Instruction 


C | | C 


LACT Load Accumulator with Shift Specified by T Register LACT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] LACT <dma> 
[<label>] LACT {*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
0 < next ARP < 7 


(PC) +1 7>PC 
(dma) x 2 register(3-0) + ACC 


lf SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 
Then (dma) is not sign-extended. 


Affected by SXM. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 Q 


QO 1 0 0 0 0O 1 0 Data Memory Address 
0 1 0 0 0 0 1 =O}1. See Section 4.1 | 


The LACT instruction loads the accumulator with a data memory value shifted left 
the number of places specified by the four LSBs of the T register. Using the T 
register’s contents as a shift code provides a variable shift mechanism. 


LACT may be used to denormalize a floating-point number if the actual exponent 
is placed in the four LSBs of the T register and the mantissa is referenced by the 
data memory address. Note that this method of denormalization can only be used 
when the magnitude of the exponent is four bits or less. 


1 
Class | (1) 
Category C 
LACT DAT1 (DP = 6) 
or 
LACT * If current auxiliary register contains 769. 
Before Instruction After Instruction 
Data Data . 
Memory >1376 Memory >1376 
769 769 


>98F7EC83 ACC >13760 
C 


C 


> 

O 

O 
>< 


T >3014 T >3014 
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Assembler Syntax 


Operands | 


Execution — 


Encoding 


se eninamece He MARY Po AnteAnrRVNERUR SERUM RNINRINNSCCNRmhtaY Mt ot A! smeoemaniteerimaieey thrptey Mmm 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 
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[<label>] LALK <constant> [,<shift> ] | 


16-bit constant  —> 
0 < shift < 15 (defaults to 0) 


(PC) +2>PC 
Constant x 2shift + ACC 


lf SXM = 1: 
Then -32768 < constant < . 32767. 
lf SXM = 0: 


Then 0 < constant < 65535. 
Affected by SXM. 


15 14 13 12 11 10 9 8 7 6 5&6 4 3 2 1 +0 





The left-shifted 16- bit immediate value is loaded into the accumulator. The shifted 
16-bit constant is sign-extended if SXM = 1; otherwise, the high-order bits of 
the accumulator (past the shift) are set to zero. Note that the MSB of the accu- 
mulator can only be set if SXM = 1 and a negative number is loaded. The shift 
count is optional and defaults to zero. 


2 | 
Class V (2) 
Category X 
LALK >F794,8 -(SXM=1) 
Before Instruction After Instruction 
ACC >12345678 ACC >FFF79400 
C Cc | 
LALK >F794,8 ~ (SXM=0) 
Before Instruction After Instruction 
ACC “i Geasesere, [>12345678 | ACC >F79400 
, c 


LAR 


Load Auxiliary Register LA 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] LAR <AR>,<dma> 
[<label>] LAR <AR>,{*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP> ] 


O < dma < 127 
O < auxiliary register AR < 7 
O < next ARP s 7 


(PC) +17 PC 
(dma) ~ auxiliary register AR 


15 14 13 12 11 10 9 8 F 6 5 4 3 2 1 = #90 


0 O 1 1 0 Auxiliary Data Memory Address 
Register 

0 OQ 1 1 0 Auxiliary 1 See Section 4.1 
Register 


The contents of the specified data memory address are loaded into the designated 
auxiliary register. 


The LAR and SAR (store auxiliary register) instructions can be used to load and 
store the auxiliary registers during subroutine calls and interrupts. If an auxiliary 
register is not being used for indirect addressing, LAR and SAR enable the register 
to be used as an additional storage register, especially for swapping values 
between data memory locations without affecting the contents of the accumulator. 


1 


Class Il (1) 
Category C 
LAR ARO , DAT10 (DP = 4) 
Before Instruction After Instruction 
Data Data 
Memory >18 Memory >18 
522 522 
LARP AR6 
LAR AR6,*- 
Before Instruction After Instruction 
Data Data 
Memory >3 2 Memory >3 2 
617 617 
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~ 









LAR, in the indirect addressing mode, ignores any AR modifications if the 
AR specified by the instruction is the same as that pointed to by the ARP. 
Therefore, in Example 2, AR6 is not decremented after the LAR instruction. 
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LARK Load Auxiliary Register Immediate Short _ LARK 





Assembler Syntax [<label>] LARK <AR>,<constant> 


Operands O < constant < 255 

O < auxiliary register AR < 7 
Execution (PC). + 1°>.PC 

8-bit constant ~ auxiliary register AR 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 =O 

1 1 0 O QO Auxiliary 8-Bit Constant 
Register 

Description The 8-bit positive constant is loaded into the designated auxiliary register right- 


justified and zero-filled (i.e., sign-extension suppressed). 


LARK is useful for loading an initial loop counter value into an auxiliary register 
for use with the BANZ instruction. 


Words 1 

Cycles Class IV (1) 
Repeatability Category X 
Example LARK ARO,>15 


Before Instruction After Instruction 


ARO ARO 
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LARP _______ Load Auxiliary Register Pointer LARP 


Assembler Syntax 


Operands 
Execution 
Encoding 


Description 


Words _ 
Cycles 
Repeatability 


Example 
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[<label>] LARP <constant> 


0 < constant < 7 


(PC). 15> PC 
(ARP) ~ ARB 
Constant ~ ARP 


Affects ARP and ARB. 


15 14 13 12 11 10 9 8 7F 6 5 4 3 2 1 =O 
0 1 0 1 0 147 O 41 41 0 O O 1 ARP 


The auxiliary register pointer is loaded with the contents of the three LSBs of the 
instruction (a 3-bit constant identifying the desired auxiliary register). The old 
ARP is copied to the ARB field of status register ST1. ARP can also be modified 
by the LST, LST1, and MAR instructions, as well as any instruction that is used 
in the indirect addressing mode. | 


The LARP instruction is a subset of MAR; i.e., the opcode is the same as MAR) 


in the indirect addressing mode. The following instruction has the same effect 
as LARP: 


MAR *,<constant> 


1 
Class IV (1) 


Category C 
LARP i Any succeeding instructions will use 
auxiliary register AR1 for indirect 


addressing. 


LDP Load Data Memory Page Pointer LDP 


Assembler Syntax 
Direct Addressing: [<label>] LDP <dma> 
Indirect Addressing: [<label>] LDP {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) +17 PC 
Nine LSBs of (dma) ~ data page pointer register (DP) status bits 
Affects DP. 
Encoding 15 14 13 12 11 10 9 8 FY? 6 5 4 3 2 1 #0 


© 


Direct 0 1 0 1 0 oO 1 Data Memory Address 
Indirect} O 1 0 1 0 0 1 0 See Section 4.1 


Description The nine LSBs of the contents of the addressed data memory location are loaded 
into the DP (data memory page pointer) register. The DP and 7-bit data memory 
address are concatenated to form 16-bit data memory addresses. The DP may 
also be loaded by the LST and LDPK instructions. 


Words 1 
Cycles Class Il (1) 
Repeatability Category C 
Example LDP DAT127 (DP = 511) 
or 
LDP = If current auxiliary register contains 65535. 
Before Instruction After Instruction 
Data Data 
Memory >FEDC Memory >FEDC 
65535 65535 


DP DP >DC 


LDPK Load Data Memory Page Pointer Immediate | LDPK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Cycles 
Repeatability 


Example 
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[<label>] LDPK <constant> 


0 < constant < 511 


(PC) +1 7 PC : 
Constant ~ data memory page pointer (DP) status bits 


Affects DP. 
15 14 13 12 11 10 9 8 %7F 6 5 4 3 2 1 = =~0 


peaoo oo to OPP 


The DP (data memory page pointer) register is loaded with a 9-bit constant. The 
DP and 7-bit data memory address are concatenated to form 16-bit direct data 
memory addresses. DP > 8 specifies external data memory. DP = 4 through 7 
specifies on-chip RAM blocks BO or B1. Block B2 is located in the upper 32 
words of page 0. DP may also be loaded by the LST and LDP instructions. 


4-- PSR A tae west o, Sed tek SR asad tain Bas en ee re ne Sols og I ca Dee ne Oh dinate Si Rae ea aime als ip alten ela 


Class IV (1) 
Category X 


LDPK 64 The data page pointer is set to 64. 


LPH Load High P Register . LPH 


Assembler Syntax 
Direct Addressing: [<label>] LPH <dma> 
Indirect Addressing: [<label>] LPH {*|*+|*-|*0+|"0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PC) +17 PC 


(dma) ~ P register(31-16) 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 0 


Direct 0 1 0 1 0 oO 1 1 Data Memory Address 
Indirect 0 1 0 1 0 oO 1 1/1 | See Section 4.1 


Description The P register high-order bits are loaded with the contents of data memory. The 
low-order P register bits are unaffected. 


The LPH instruction is particularly useful for restoring the high-order bits of the 
P register after subroutine calls or interrupts. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example LPH DATO (DP = 4) 
or 
LPH * If current auxiliary register contains 512. 


Before Instruction After Instruction 


Data Data 
Memory >F79C Memory >F79C 

512 512 
P >30079844 P >F79C9844 


LRLK Load Auxiliary Register Long Immediate __LRLK 


Assembler Syntax [<label>] LRLK <AR>,<constant> 


Operands - 0 < auxiliary register < 7 
O < constant < 65535 
Execution (PC) +27 PC 


Constant ~ AR 
Not affected by SXM; does not affect SXM. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


1 1 0 1 +Of AR | 0 0 0 0 0 0 0 0 
16-Bit Constant | 


Description The 16-bit immediate value is loaded into the auxiliary register specified by the 
AR field. The specified constant must be an unsigned integer, and its value is 
not affected by SXM. 


Cycles Class V (2) | 
Repeatability Category X 
Example LRLK AR3,>3080 


Before Instruction After Instruction 


AR3 >7F80 AR3 >3080 
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LST Load Status Register STO LST 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


[<label>] LST <dma> 
[<label>] LST {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
QO < next ARP < 7 


(PC) +17 PC 
(dma) > status register STO 


Affects ARP, OV, OVM, and DP. 
Does not affect INTM or ARB. 


15 14 13 12 11 10 8 7 6 5 4 3 2 1 =O 
0 


9 
Direct 0 1 0 1 0 0 Data Memory Address 
1 O 1 0 0 


0 
Indirect 0 O° 4 See Section 4.1 


Description 


Words 
Cycles 
Repeatability 


Example 1 


2 


Status register STO is loaded with the addressed data memory value. Note that 
the INTM (interrupt mode) bit is unaffected by LST. ARB is also unaffected even 
though a new ARP is loaded. If a next ARP value is specified via the indirect 
addressing mode, the specified value is ignored. Instead, ARP is loaded with the 
value contained within the addressed data memory word. 


The LST instruction is used to load status register STO after interrupts and 
subroutine calls. The STO contains the status bits: OV (overflow flag) bit, OVM 
(overflow mode) bit, INTM (interrupt mode) bit, ARP (auxiliary register pointer), 
and DP (data memory page pointer). These bits were stored (by the SST 
instruction) in the data memory word as follows: 


15 13 12 #11 + «2410 8 7 6 5 4 3 2 1 0 


14 9 
[ane Povovm 1 tm] SSC—tSSCSCS 


1 

Class Il (1) 

Category C 

LARP 0 

LST e7 The data memory word addressed by the 


contents of auxiliary register ARO is 
loaded into status register STO, except 
for the INTM bit. Note that even 

though a next ARP value is specified, 
that value is ignored, and even though a 
new ARP is loaded, the old ARP is not 
loaded into ARB. 





Example 2 _ LST = >60. 


| Data 
Memory 
96 


STO 


ST1 


Example3 = ‘LARP AR7 


LST = ¥= 


AR7 : 


Data. 
Memory 
1023 


STO. 


ST1 


Example 4 LARP AR7 


LST Pee. 


AR7 


Data 
Memory 
1023 


STO 


ST1 
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(DP = 0) 
Before Instruction 


>2404 


>6 E00 


>0580 


(AR7 = >3FF) 


Before Instruction 





>CEO6 | 


>FCO4 


>E780 


(AR7 = >3FF) 


Before Instruction 
>3 FF 


>EEO4 


>EEOO 


| >F780 


Data 


~ Memory — 
9 


STO 


ST1 


ART 


Data 
Memory 
1023 


STO 


ST1 


AR7 


Data 
Memory 


STO 


ST1 


_. After Instruction 


 >2404 


>2604 


>0580 


After Instruction 


FSFE, 


>CEO6 


>C C06 


>E780 


After Instruction 
>3 FE 


>EEO4 


>EEO4 


>F 780 


LST1 Load Status Register ST1 __LST1 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] LST1 <dma> 
[<label>] LST1 {*|*+]|*-|*0+|*0-|"BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP gs 7 


(PC) +17 PC 

(dma) ~ status register ST1 

(ARB) > ARP 

Affects ARP, ARB, CNF, TC, SXM, C, HM, FSM, XF, FO, TXM, and PM. 


8 7 6 5 4 3 2 1 =O 


1 11.10 9 
Direct 0 1 0 0O O 1 Data Memory Address 
Indirect | 0 1 0 0 0 1 See Section 4.1 


5 14 13 12 
1 O 
1 O 


Status register ST1 is loaded with the data memory value. The bits of the data 
memory value, which are loaded into ARB, are also loaded into ARP to facilitate 
context switching. Note that if a next ARP value is specified via the indirect 
addressing mode, the specified value is ignored. 


LST1 is used to load status bits after interrupts and subroutine calls. ST1 contains 
the status bits: ARB (auxiliary register pointer buffer), CNF (RAM configuration 
control) bit, TC (test/control) bit, SXM (sign-extension mode) bit, C (carry) bit, 
HM (hold mode) bit, FSM (frame synchronization mode) bit, XF (external flag) 
bit, FO (serial port format) bit, TXM (transmit mode) bit, and the PM (product 
register shift mode) bit. These bits are loaded into the status register from the 
data memory word as follows: 


15 14 13 #12~ «11 10 9 8 7 6 5 4 3 2 1 0 
sxM]_C [1 1 [HM|rsm] XF [FO [TxM] PM 
1 
Class Il (1) 

Category C 
LARP 3 
LST1 The data memory word addressed by the 
contents of auxiliary register AR3 
replaces the status bits of status 
register ST1l, and AR3 is decremented. 
LST1 >61 (DP = 0) 
Before Instruction After Instruction 
Data Data 
Memory >0580 Memory >0580 
97 97 
STO >ACO0O0 STO >0C00 
ST1 >0581 ST1 >0580 





Example 3 LARP AR7 (AR7 = >3FE) 
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 LStTil t= 
Before Instruction | After Instruction 
ART ART 
Data _ Data 
Memory >4F90 ~ Memory >4F90 
1022 ) — 1022 
STO >FC04 STO >5 C04 
ST1 ~ >E780  §Tt >4F90 
Example 4 LARP AR7 | (ART = >3FE) | 
Before Instruction After Instruction 
ART ART 
Data Data 
Memory >6190 Memory >6190 
1022 1022 
STO >FEO4 STO >7E04 
ST1 >0593 ST1 >6190 


LT Load T Register ; LT 


Assembler Syntax 
Direct Addressing: [<label>] LT <dma> 
Indirect Addressing: [<label>] LT {*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) 7 > PC 


(dma) ~ T register 


Encoding 15 14 13 12 11 10 9 8 FY 6 5 4 3 2 1 =O 
Direct 0 oO 1 1 1 1 0 O Data Memory Address 


Indirect] O O 1 #1 #1 +1 #0 Of 1) See Section 4.1 


Description The T register is loaded with the contents of the specified data memory location. 
The LT instruction may be used to load the T register in preparation for multipli- 
cation. See also the LTA, LTD, LTP, LTS, MPY, MPYA, MPYK, MPYS, and MPYU 
instructions. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example Er DAT24 (DP = 8) 
or 
Lr * If current auxiliary register contains 1048. 
Before Instruction After Instruction 
Data Data 
Memory >6 2 Memory >6 2 
1048 1048 


1 1 62 


> 


LTA Load T Register and Accumulate Previous Product LT 


Assembler Syntax es | 
Direct Addressing: [<label>] LTA <dma> | | ; 
Indirect Addressing: [<label>] LTA {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O<dma < 127 
O < next ARP < 7 
Execution (PC). + 7 > PC 


(dma) > T register 
(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by OVM and PM. 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 +0 


Direct} 0 O 1 1 #1 #71 +0 140) Data Memory Address 
Indirect] 0 O 1 1 #1 #1 #0 1414 See Section 4.1 


“Description = —_~—sThe T register is loaded with the contents of the specified data memory address. 


The contents of the product register, shifted as defined by the PM status bits, are 
added to the accumulator, with the result left in the accumulator. 


The function of the LTA instruction is included in the LTD instruction. 


Words 1 
Cycles Class | (1) 
Repeatability | Category B 
Example | LTA DAT 36 (DP = 6, PM = 0) 
or 
LTA * If current auxiliary register contains 804. 
Before Instruction After Instruction 
Data Data 
Memory >6 2 Memory 6 2 
804 804 


3 


— 
— 
V V 
mo 
NO 


> 
©) 
©) 
0 L>X<. 


5 ACC [o] S44 
C 
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LTD Load T Register, Accumulate Previous Product, and Move Data LTD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] LTD <dma> 
[<label>] LTD {*|*+|*-]*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1—> PC 

(dma) ~ T register 

(dma) ~ dma + 1 

(ACC) + (shifted P register) ~ ACC 


Affects C and OV; affected by OVM and PM. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #O 


0 O 1 1 1 1 1 1] 0) Data Memory Address 





1 1 1 See Section 4.1 


The T register is loaded with the contents of the specified data memory address. 
The contents of the P register, shifted as defined by the PM status bits, are added 
to the accumulator, and the result is placed in the accumulator. The contents of. 
the specified data memory address are also copied to the next higher data memory 
address. This instruction is valid for blocks B1 and B2, and is also valid for block 
BO if block BO is configured as data memory. The data move function is contin- 
uous across the boundary of blocks BO and B1, but cannot be used with external 
data memory or memory-mapped registers. This function is described under the 
instruction DMOV. Note that if used with external data memory, the function of 
LTD is identical to that of LTA. 


1 
Class | (1) 
Category B 
LTD DAT126 (DP = 7, PM = 0) 
or 
LTD > If current auxiliary register contains 1022. 
Before Instruction After Instruction 
Data Data 
1022 1022 
Data Data 
Memory Memory 62 
1023 1023 
1 1 62 
Acc Acc 14 


ol ES 
alo] 
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LTP ____Load T Register and Store P Register in Accumulator LT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Oparenda 


Execution 


Encoding 
Direct 


Indirect 


Words 
Cycles 
Repeatability 


Example 


4-82 


a 


[<label>] LTP <dma> 
[<label>] LTP {*|*+]*-|*0+|*0- *BRO-+|*BRO- }L< <next ARP>] 


0 < dma < 127 
0 < next ARP < 7 


(PC) +17PC 

(dma) > T register 
(shifted P register) ~ ACC 
Affected by PM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 


0 OO 1 1 1 1 1 0 Data Memory Address 


0 QO 1 1 1 1 1 0 See Section 4.1 


i 
i 
: 
' 
5 
i 
| 
1 
i 
i 
i 
i 
: 
} 
i 
t 
j 
i 
1 
t 
I 
j 
j 
i 
i 
4 
‘ 
4 
4 
i 
+ 
} 


The T register is loaded with the contents of the addressed data memory location, 


and the product register is stored in the accumulator. The shift at the output of 
the product register is controlled by the PM status bits. 


1 
Class | (1) 
Category C 
LTP DAT36 (DP = 6, PM = 0) 
or 
LTP * If current auxiliary register contains 804. 
Before Instruction After Instruction 
Data Data 
Memory >6 2 Memory >6 2 
804 804 
T T >6 2 
acc ace 
Cc C 


LTS Load T Register, Subtract Previous Product __ _ LTS 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 





[<label>] LTS <dma> | 
[<label>] LTS {*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP> 


O < dma < 127 
O < next ARP < 7 


(PG) 41-2 PC 
(dma) > T register 
(ACC) - (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 


0 1 0 1 1 0 1 1 ro. Data Memory Address 
oO 1 1 See Section 4.1 


The T register is loaded with the contents of the addressed data memory location. 
The contents of the product register, shifted as defined by the contents of the PM 
status bits, are subtracted from the accumulator. The result is left in the accu- 
mulator. 


1 





Class | (1) 
Category B 
LTS DAT36 (DP = 6, PM = 0) 
or | 
LTS * If current auxiliary register contains 804. 
Before Instruction After Instruction 

Data Data 
Memory >6 2 Memory | >6 2 
804 804 

1 
Acc ace” fo] GFFFFFFFe 

C C 


a 
© 
io) 


MAC Multiply and Accumulate MAC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Direct 


| indirect 


. Program Memory Address 


Description 


Words 
Cycles 
Repeatability 
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[<label>] ‘MAC <pma>, uae 
ae MAC <pma>,{*|*+]|*-|* OF 0: *BRO+|*BRO- }L<next ARP>] 


0 < pma < 65535 
0 < dma < 127 
0 < next ARP s 7 


(PC) +27 PC 
(PFC) ~ MCS 
(pma) ~ PFC 


While (repeat counter) # 0: 
(ACC) + (shifted P register) > > ACC, 
(dma) ~ T.register, 
(dma) x (pma, addressed by PFC) -> P register, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 > PFC, 


(ACC) + (shifted P register) ~ ACC 

(dma) ~ T register 

(dma) x (pma, addressed by PFC) > P register 
Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


Affects C and OV; affected by OVM and PM. 


eS 8 


01 0 1 1 Data Memory Address __ 
—— en Address 


oO 1 01 1 4 0 1417 See Section 4.1 


The MAC instruction multiplies a data memory value (specified by dma) by a 
program memory value (specified by pma). It also adds the previous product, 
shifted as defined by the PM status bits, to the accumulator. 


The data and program memory locations may be any nonreserved, on-chip or 
off-chip memory locations. If the program memory is block BO of on-chip RAM, 
then the CNF bit must be set to one. Note that the upper eight bits of the program 
memory address should be set to >FF to address BO program RAM, and the upper 
six bits of dma should be set to 0 to address a location below 1024. When used 


in the direct addressing mode, the dma cannot be modified during repetition of 


the instruction. 


When the MAC instruction is repeated, the program memory address contained 
in the PFC is incremented by one during its operation. This enables accessing a 
series of operands in memory. MAC is useful for long sum-of-products oper- 
ations, since MAC becomes a single-cycle instruction once the RPT pipeline is 
started. 


2 
Class VI (4) 
Category A 


MAC Multiply and Accumulate MA 


Example SPM 3 Select a "shift-right-by-6" mode on PR output. 
CNFP Configure block BO as program memory (>FFXX). 
LARP 1 Use AR1 to address block Bl. 
LRLK 1,768 Point to lowest location in RAM block Bl. 
RPTK 255 Compute 256 sum-of-product operations. 


MAC >FFOO,*+ Multiply/accumulate and increment ARI. 


The following example shows register and memory contents before and after the 
third step repeat loop: 


Before Instruction After Instruction 
Ant ARI 
RPT >F D RPT ZEA 
PFC >FFO2 ~ PEC >FFO3 
Data Data 
770 770 
Program Program 
Memory >FAAA Memory. >FAAA 
65282 65282 
P >458972 P >FFFF453E 
ACC >723EC41 acc fo] | >7250266 
C C 


o1 
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MACD Multiply and Accumulate with Data Move ____MACD 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


4-86 


Direct 


Indirect 


[<label>] MACD <pma>,<dma> 
[<label>] MACD <pma>,{*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < pma < 65535 
0 < dma < 127 
0 < next ARP < 7 


(PC) +2->PC 
(PFC) ~ MCS 
(pma) > PFC 


While (repeat counter) # 0: 
(ACC) + (shifted P register) ~ ACC, 
(dma) > T register, 
(dma) x (pma, addressed by PFC) > P register, 
(dma) ~ dma + 1, 


Modify AR(ARP) and ARP as specified, 


(repeat counter) - 1 ~ repeat counter. 


(ACC) + (shifted P register) ~ ACC 

(dma) ~ T register 

(dma) x (pma, addressed by PFC) > P register 
(dma) ~ dma + 1 

Modify AR(ARP) and ARP as specified. 
(MCS) ~ PFC 


Affects C and OV; affected by OVM and PM. 


15 14 13 12 11 10 9 8 7F 6 5 4 3 2 1 =O 


oO 1 0 1 1 #1 #90 +0 0 | Data Memory Address 
| | Program Memory Address 


i ae a er ee ee See Section 4.1 
Program Memory Address 


The MACD instruction multiplies a data memory value (specified by dma) by a 
program memory value (specified by pma). It also adds the previous product, 
shifted as defined by the PM status bits, to the accumulator. 


The data and program memory locations may be any nonreserved, on-chip or 
off-chip memory locations. If MACD addresses one of the memory-mapped 
registers or external memory as a data memory location, the effect of the instruc- 
tion will be that of a MAC instruction (see the DMOV instruction description). 


lf the program memory is block BO of on-chip RAM, then the CNF must be set 
to one. Note that the upper eight bits of the program memory address should 
be set to >FF to address BO program RAM, and the upper six bits of the effective 
16-bit dma should be set to O to address a location below 1024. When used in 
the direct addressing mode, the dma cannot be modified during repetition of the 
instruction. 


MACD functions in the same manner as MAC, with the addition of data move for 
block BO, B1, or B2. Otherwise, the effects are the same as for MAC. This feature 
makes MACD useful for applications such as convolution and transversal filtering. 


and Accumulate with Data Move 


MACD Multiply MACD 


Words 
Cycles 
Repeatability 


Example 


When the MACD instruction is repeated, the program memory address contained 
in the PFC is incremented by one during its operation. This enables accessing a 
series of operands in memory. When used with RPT or RPTK, MACD becomes 


a single-cycle instruction once the RPT pipeline is started. 


2 
Class VI 
Category 


SPM 

SOVM 
CNFP 
LARP 
LRLK 
RPTK 
MACD 


(4) 
A 


0 


3 
3,1023 
255 


Select no shift mode on PR output. 


Set overflow mode. 


Configure block BO as program memory (>FFXX). 


Use AR3 to address block Bl. 


Point to highest location in RAM block Bl. 

Compute 1 sample of a length-256 convolution. 
>FFOO,*- Multiply/accumulate, shift data word in block 
Bl, and decrement AR3. 


The following example shows register and memory contents before and after the 
third step repeat loop: 


AR1 
RPT 
PFC 
Data 


Memory 
1021 


Data 
Memory 


Program 
Memory 
65282 


ACC 


Note: 


OLX] 


V V 
NO “TI 
W O 


ofe] 


Before Instruction 
>3 FD 


>FFO2 


>7FC 


>FAAA 


>458972 


>723EC41. 


ARI 
RPT 
PFC 


Data 
Memory 
1021 


Data 
Memory 
1022 


Program 
Memory 
65282 


Pp 


ACC 


After Instruction 
>3 FC 


V 
-“ 
O 


>FFO3 


>23 


NO 
OO 


>FAAA 


>FFFF453E 


>76975B3 


The data move function for MACD can only occur within on-chip data RAM 
blocks BO, B1, and B2. 
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Assembler. Syntax 
Direct Addressing: 
- Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


mode. In the indirect addressing mode, the auxiliary registers and the ARP are... _ 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


Example 3. 


4-88 


[<label>] MAR <dma> | | 
[<label>] MAR {*|*+[*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 
O<dma<127 | — a 

O < next ARP <7 


(PC) +17 PC : 
Modifies ARP, AR(ARP) as specified by the indirect 
addressing field (acts as a NOP in direct addressing). 


15 14 1312 1110 9 8 7 6 56 4 3 2 1 «0 


Oo 4.0 41:0 4% OO oO) Data Memory Address 
1 0.1 ©: 4 6 aia) See Section 4.1 


The MAR instruction acts as a no-operation instruction in the direct addressing 


modified; however, no use is made of the memory being referenced. MAR is used 
only to modify the auxiliary registers or the ARP. The old ARP is copied to the 
ARB field of status register ST1. Note that any operation that MAR performs can 
also be performed with any instruction that supports indirect addressing. ARP 
may also be loaded by an LST instruction. 


In the direct addressing mode, MAR is a NOP. Also, the instruction LARP its a 
subset of MAR (i.e., MAR *,4 performs the same function as LARP 4). 

, 

Class IV (1) 

Category C 


MAR Fe Load the ARP with 1. 


Before Instruction After Instruction 
MAR a Decrement current auxiliary register (in this 
case, AR1) 
Before Instruction After Instruction 
MAR *+,5 Increment current auxiliary register (AR1) and 
| load ARP with 5. °: 
Before Instruction After Instruction 


AR’ >3 4 ART a >35 | 


> 
ms 
0 
> 
Be 
0 


MPY Multiply _MPY 


Assembler Syntax 
Direct Addressing: [<label>] MPY <dma> | 
Indirect Addressing: [<label>] MPY {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP s 7 
Execution (PC) +17 PC 


(T register) x (dma) ~ P register 


Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 = =O 


Direct 0 O 1 1 1 0 O O Data Memory Address 
Indirect} 0 O 1 1 #1 #0 0 0 See Section 4.1 


Description The contents of the T register are multiplied by the contents of the addressed data 
memory location. The result is placed in the P register. 
Words 4 | 
Cycles Class | (1) 
Repeatability Category C 
Example MPY DAT13 (DP = 8) 
or 
MPY * If current auxiliary register contains 1037. 
Before Instruction After Instruction 
Data Data 
Memory Memory >7 


1037 1037 


>6 


_ 
—_ 


> 





Assembler Syntax 
Direct Addressing: 
Indirect Addressing: © 


Operands. 


Execution 


Encoding | 
- Direct 


Indirect | 


Description 


Words 
Cycles 
Repeatability 


Example 


4-90 






[<label>] MPYA <dma> . | 


[<label>] MPYA {*|*+|*-|"0+|*0-|"BRO+|*BRO-}[,<next ARP>] 
0 < dma < 127 | ere 


0 < next ARP <7 


(PC) Fel = PC 
(ACC) + (shifted P register) > ACC 
(T register) x (dma) — P register 


Affects C and OV; affected by OVM and PM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


O O 1 1 1 QO 1 of o| Data Memory Address 






memory location. The result is placed in the P register. The previous product, 
shifted as defined by the PM status bits, is also added to the accumulator. 


1 
Class | (1) 
Category A 
MPYA DAT13 (DP = 6, PM = QO) 
or | 
MPYA * If current auxiliary register contains 781. 
Before Instruction | 7 After Instruction 
Data . Data 
781 781 
1 
P >3 6 P >2A 
ACC >5 4 acc [ol >8 A 
C C 


0 . See Section 4.1 | 


The contents of the T register are multiplied by the contents of the addressed data 


MPYK Multiply Immediate | _MPYK 


Assembler Syntax 


Operands 


Execution 


Encoding 
Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] MPYK <constant> 


-4096 <cconstant < 4095 
-212 < constant < 212 - 1 


(PC) +17 PC 
(T register) x constant ~ P register 


Not affected by SXM. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 14 =O 


1 0 1 13-Bit Constant 


The contents of the T register are multiplied by the signed, 13-bit constant. The 
result is loaded into the P register. The immediate field is right-justified and 
sign-extended before multiplication, regardless of SXM. 


1 

Class IV (1) 
Category X 
MPYK -9 


Before Instruction After Instruction 


T T 
P >2 A P >FFFFFFC1 
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Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


[<label>] 


O < dma < 127 


[<label>] MPYS <dma> 
MPYS {*|*+]|*-|* O+|* O- peels BRO- }[,<next ARP>] 


O < next ARP <7 > 


(ACC) - 


PC) et > PG 
(shifted P register) ~ ACC 


(T register) x (dma) > P register 


_ Affects C and OV; affected by OVM and PM. 


Encoding 


Direct. | 


Indirect 


_ Description 


Words 
Cycles 
Repeatability 


Example 
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15 14 
0 O 


13 


1 


12 11 10 9 
1 1 0 1 


6 


4 


1 | 0 | Data Memory Address 
1 ie See Section 4.1 


The cc contents of the T register a are e multiplied ey. thew contents sce the addressed. daa 


3 2 1 O 





memory location. The result is placed in the P register. The previous product, 
shifted as defined by the PM status bits, is also subtracted from the accumulator. 


1 


Class | (1) 
Category A 


MPYS 


or 
MPYS 


Data 
Memory 
781 


ACC 


DAT13 


* 


OLX] 


(DP = 6, PM=0 


If current auxiliary register contains 781. 


Before Instruction 


Data 
Memory 
781 


After Instruction 


MPYU Multiply Unsigned MPYU 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] MPYU <dma> 
[<label>] MPYU {*|*+]*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
Unsigned (T register) x unsigned (dma) > P register 


15 14 13 12 11 10 9 8 7F7 6 5 4 3 2 1 #90 


1 1 0 O 1 1 1 1] 0 | Data Memory Address 
1. * O70 FT 4 tay See Section 4.1 


The unsigned contents of the T register are multiplied by the unsigned contents 
of the addressed data memory location. The result is placed in the P register. Note 
that the multiplier acts as a 17 x 17-bit signed multiplier for this instruction, with 
the MSB of both operands forced to zero. 


The shifter at the output of the P register will always invoke sign-extension on 
the P register when PM = 3 (right-shift by 6 mode). Therefore, this shift mode 
should not be used if unsigned products are desired. 


The MPYU instruction is particularly useful for computing multiple-precision 
products, such as when multiplying two 32-bit numbers to yield a 64-bit product. 


1 
Class | (1) 
Category C 
MPYU DAT16 (DP = 4) 
or 
MPYU x If current auxiliary register contains 528. 
Before Instruction After Instruction 
Data Data 
Memory >FFFF Memory >FFFF 
528 528 


>FFFF >FFFF 


P > P >FFFEO0O01 


—| 
oad 


NEG | Negate Accumulator _ __NEG 


Assembler Syntax [<label>] NEG 


Operands None 


Execution (PO) 1. PC 
(ACC) x -1 ~ ACC 


Affects C and OV; affected by OVM. 


Encoding 15 14 13 12 11 10 9 8 FY 6 5 4 3 2 1 =O 
1 1 0 O 1 1 1 0 O O 1 0 0 0 1 1 


Description The contents of the accumulator are replaced with its arithmetic complement 
(two's complement). The OV bit is set when taking the NEG of >80000000. If 
OVM = 1, the accumulator contents are replaced with >7FFFFFFF. If OVM = 
O, the result is >80000000. The carry bit C is reset to zero by this instruction for 
all nonzero values of the accumulator, and set to one if the accumulator equals 


zero. 
gee testy ce le es 
Cycles Class IV (1) 
Repeatability Category C 
Example NEG 
Before Instruction | After Instruction 
ACC >FFFFF228 acc [0] 
C C 
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NOP No Operation . | NOP 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] NOP 

None 

(PC) +17 PC 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
Oo 1 0 1 0 14 0 1 0 0 0 0 0 0 0 0 


No operation is performed. The NOP instruction affects only the PC. NOP func- 
tions in the same manner as the MAR instruction in the direct addressing mode; 
NOP has the same opcode as MAR in the direct addressing mode with dma = 
0. 


The NOP instruction is useful as a pad or temporary instruction during program 
development. 


1 
Class IV (1) 
Category B 


NOP 


4-95 


NORM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 
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Normalize Contents of Accumulator _NORM 


[<label>] NORM {*|*+|*-|"0+|*0-|[*BRO+|*BRO-} 


None 


(PC) +17 PC 


If (ACC) =0 
Then TC > 1; 
Else, if (ACC(31)).XOR.(ACC(30)) = 0: 
Then TC > QO, 
(ACC) x 2 ~ ACC, 
Modify AR(ARP) as sdecitied: 
Else TC > 1. 


Affects TC; affected by TC. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 





The NORM instruction is provided for normalizing a signed number that is 
contained in the accumulator. Normalizing a fixed-point number separates it into 
a mantissa and an exponent. To do this, the magnitude of a sign-extended number 
must be found. ACC bit 31 is exclusive-ORed with ACC bit 30 to determine if 
bit 30 is part of the magnitude or part of the sign extension. If they are the same, 
they are both sign bits, and the accumulator is left-shifted to eliminate the extra 
sign bit. 


The AR(ARP) is modified as specified to generate the magnitude of the exponent. 
It is assumed that AR(ARP) is initialized before the normalization begins. The 
default modification of the AR(ARP) is an increment, making tt compatible with 
the TMS32020. 


Multiple executions of the NORM instruction may be required to completely 
normalize a 32-bit number in the accumulator. Although using NORM with RPT 
or RPTK does not cause execution of NORM to “fall out” of the repeat loop 
automatically when the normalization is complete, no operation is performed for 
the remainder of the repeat loop. Note that NORM functions on both positive 
and negative two’s-complement numbers. 


1 
Class IV (1) 
Category A 


31-Bit Normalization: 


LARP a Use AR1 for exponent storage. 
LARK 70 Clear out exponent counter. 
LOOP NORM + One bit is normalized. 
BBZ LOOP If TC = 0, magnitude is not found yet. 


NORM Normalize Contents of Accumulator | NORM 


Example 2 


15-Bit Normalization: 


LARP 1 Use AR1 to store the exponent. 
LARK aca Initialize exponent counter. 
RPTK 14 15-bit normalization is specified 


(yielding a 4-bit exponent and a 16-bit 
mantissa). 

NORM Ke NORM automatically stops shifting 
when the first significant magnitude 
bit is found, performing NOPs for the 
remainder of the repeat loop. 


The first method is used to normalize a 32-bit number and yields a 5-bit exponent 
magnitude. The second method is used to normalize a 16-bit number and yields 
a 4-bit exponent magnitude. If it is known that the number requires only a small 
amount of normalization, the first method may be preferable to the second. This 
results because Example 1 runs only until normalization is complete. Example 2 
always executes all 15 cycles of the repeat loop. Specifically, Example 1 is more 
efficient if the number requires five or less shifts. lf the number requires six or 
more shifts, Example 2 is more efficient. 


Note: 


Source code compatibility with the TMS32020 allows the NORM instruction 
to be used without a specified operand. In that case, any comments on the 
same line as the instruction will be interpreted as the operand. If the first 
character is an asterisk (“), then the instruction will be assembled as 


NORM * with no auxiliary register modification taking place upon execution. 
The user is therefore advised to replace the NORM instructions with 
NORM *+ when the default modification of increment is desired. 


The resulting value in the auxiliary register will not be the real exponent of the 
number for all modification options. However, it can always be used to obtain 
the exponent. 





— 4-97 


OR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


_ Description 


Words 
Cycles 
Repeatability 


Example 
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__.. OR with Accumulator | __OR 


[<label>] OR <dma> | | 
[<label>] OR {*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1 7>PC 


(ACC(15-0)) .OR.dma ~ ACC(15-0) 
(ACC(31-16)) ~ ACC(31-16) 


Not affected by SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #90 


0 1 0. 0 1 1 O 1 Oe) Data Memory Address | 
1 | See Section 4.1 





The low-order bits of the accumulator are ORed with the contents of the 


addressed data memory location. The high-order bits of the accumulator are ORed 
with all zeroes. Therefore, the upper half of the accumulator is unaffected by this 
instruction. 


1 
Class | (1) 
Category B 
OR DAT8 (DP = 8) 
or 
OR * Where current auxiliary register contains 1032. 


Before Instruction After Instruction 


Data Data 
Memory >FOO0O Memory >FOOO 


1032 1032 


C C 


ORK OR Immediate with Accumulator with Shift ORK 


Assembler Syntax [<label>] ORK <constant>[,<shift>] 


Operands 16-bit constant 
0 < shift < 15 (defaults to 0) 
Execution (PC) +2—7PC 


(ACC(30-0)).OR.[constant x 2Shift] + ACC(30-0) 
(ACC(31)) > ACC(31) | 


Not affected by SXM. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 


1 1 °0 1] Shift |o 0 0 0 01 0 1 
16-Bit Constant 


Description The left-shifted 16-bit immediate constant is ORed with the accumulator. The 
result is left in the accumulator. Low-order bits below and high-order bits above 
the shifted value are treated as zeroes. The corresponding bits of the accumulator 
are unaffected. Note that the most-significant bit of the accumulator is not 
affected, regardless of the shift code value. 


Words 2 
Cycles Class V (2) 
Repeatability Category X 
Example ORK >FFFF,8 
Before Instruction After Instruction 
acc [x] [>12345678 ACC >12FFFF78 
C Cc 
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Assembler Syntax 
Direct Addressing: [<label>] OUT <dma>, <PA> 
Indirect Addressing: [<label>] OUT {*|*+|*- "O+|"0- *BRO+|*BRO- 3,<PAL <next eae 


Operands sO gs dma < 127 |” 
0 < next ARP < 7 
0 < port address PA < 15 


Execution (PC) +17 PC 
| | - Port address PA ~ address bus A3-A0O_ 
0 ~ address bus A15-A4 
(dma) ~ data bus D15-D0 


Encoding © 15 14 13 12 1110 9 8 7 6 5&5 4 3 2 1 «0 


Direct Port Data Memory Address 
| Address 7 


_Indirect| 1..°1 +1 O| Po — _..... See Section41 | _. 


~ Address — 





Description The OUT instruction writes a 16-bit value from a data memory location to the 
specified |/O port. The IS line goes low to indicate an I/O access, and the 
STRB, R/W, and READY timings are the same as for an external data memory write. 
OUT is a single-cycle instruction when in the PI/DI memory configuration (see 





| Appendix E). 
Words 1 
Cycles Class X (1) 
Repeatability Category A 
Example OUT >78,7 (DP = 4) Output data word stored in data 


memory location >78 to peripheral on 
port address 7. 

OUT * OF Output data word referenced by current 
auxiliary register to peripheral on port 
address >F. 
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PAC Load Accumulator with P Register PAC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] PAC 


None 


(PC) +17 PC 
(shifted P register) ~ ACC 


Affected by PM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =°0 
1 1 0 0 1 14 14 0 0 0 0. 147 0 141 O 90 


The contents of the P register are loaded into the accumulator, shifted as specified 
by the PM status bits. | 


1 

Class IV (1) 

Category C 

PAC (PM = 0) 


Before Instruction After Instruction 


acc 23] ace 
C 


C 
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Assembler Syntax 
Operands © 


Execution — 


Encoding 


Description — 


Words 
Cycles | 
Repeatability 


Example 
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[<label>] POP 


~None> 


(PC) +17 PC 
(TOS) ~ ACC(15-0) 
0 ~ ACC(31-16) 
Pop stack one level. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2.1 #0 
1 1 0 0 141 4 4 O08 0 0 O0 141 41 4 O 1 


The contents of the top of the stack (TOS) are copied to the low accumulator, 
and the stack popped after the contents are copied. The upper half of the accu- 
mulator is set to all zeros. The hardware stack is a last-in, first-out stack with eight 
locations. Any time a pop occurs, every stack value is copied to the next higher 
stack location, and the top value is removed from the stack. After a pop, the 


- bottom two stack words will have the same value. Because each stack value is 
sian e e % . . a occur: ‘Dheies se ithlah eb ilelede at 


before any pushes occur, all levels of the stack contain the same value. No 
provision exists to check stack underflow. 


1 
Class IV (1) 
Category C 
POP 
Before Instruction After Instruction 
C | Cc 
STACK STACK 








Assembler Syntax | 
Direct Addressing: [<label>] POPD <dma> 
Indirect Addressing: [<label>] POPD {*|*+|*-|*0+/*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) +17PC 
(TOS) 7 dma 


POP stack one level. 


Encoding 15 14 13 12 11 10 9 8 F7 6 5 4 3 2 1 =O 


Direct QO 1 1 1 1 0 1 0 0 - Data Memory Address ] 
Indirect a 0 P| See Section 4.1 


Description The value from the top of the stack is transferred into the data memory location 
specified by the instruction. The values are also popped in the lower seven 
locations of the stack. The hardware stack is described in the previous instruction 
POP. The lowest stack location remains unaffected. No provision exists to check 
stack underflow. 





Words 1 
Cycles Class Ill (1) 
Repeatability Category A 
Example POPD DAT100 (DP = 8) 
} Ae | 
POPD x If current auxiliary register contains 1124. 
Before Instruction After Instruction 
Data , Data. 
Memory >55 Memory >92 
1124 aaa 1124 
Stack Stack 
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Assembler Syntax 
Direct Addressing: [<label>] -PSHD <dma> 
_ Indirect Addressing: [<label>] PSHD cara |*0+|*O-|*BRO+|* BRO- 0-31, <next ARP>] 


Operands | 0 < dma < 127 

O < next ARP < 7 
Execution | (dma) ~ TOS 

| (PC) +17PC 


Push all stack locations down one level. 


Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


Direct} 0 1 0 1 0 1 0-0 7 Data Memory Address 
Indirect | O- 0 See Section 4.1 


Description The value from the data memory location specified by the instruction is transferred 





-. 49-the-top-of the-staek. The-values-are—alse pushed-dewn-in-thetower-seven- 


locations of the stack, as described in the next instruction PUSH. The lowest stack 
location. is lost. 


Words | 1 
_ Cycles Class | (1) 
Repeatability Category A 
Example PSHD DAT127 (DP = 3) 
or | 
PSHD * If current auxiliary register contains 511. 
Before Instruction — After Instruction 
Data Data 
Memory >6 5 Memory | >6 5 
— 511 511 
Stack Stack 
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PUSH 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Push Low Accumulator onto Stack PUSH 


[<label>] PUSH 


None 


(PC) +1 7PC 
Push all stack locations down one level. 
(ACC(15-0)) ~ TOS 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 1 O O 1 1 1 O O O Q 1 1 1 O 0 


The contents of the lower half of the accumulator are copied onto the top of the 
hardware stack. The stack is pushed down before the accumulator value is copied. 
The hardware stack is a last-in, first-out stack with eight locations. If more than 
eight pushes (due to CALA, CALL, PSHD, PUSH, or TRAP instructions) occur 
before a pop, the first data values written will be lost with each succeeding push. 


1 
Class IV (1) 
Category C 
PUSH 
Before Instruction After Instruction 
ACC ACC 
STACK STACK 
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RC | = _ Reset Carry Bit | | RC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 


Repeatability 


Example 
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[<label>] RC 


‘None 


(PC) +17 PC 
0 > carry bit C in status register ST1 


Affects C. 


15 14 13 12 1110 9 8 F7 6 5 4 3 2 1 #0 
1 #1 0 0 4 4 41 0 0 0 1 141 0 O0 OD ODO 


The carry bit C in status register ST1 is reset to logic zero. The carry bit may also 
be loaded directly by the LST1 and SC instructions. 


1 
Class IV (1) | 
Category C 


RC The carry bit C is reset to logic zero. 


RET 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Return from Subroutine | . RET 


[<label>] RET 


None 


(TOS) > PC 
Pop stack one level. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 1 0 0 14 14 4 0 0 0. %4 O00 O0 14 14 =O 


The contents of the top stack register are copied into the program counter. The 
stack is then popped one level. RET is used with CALA and CALL for subroutines. 


1 
Class VIII (3) 
Category X 
RET 
Before Instruction After Instruction 
STACK > STACK > 


VVV 


> 
> 
> 


V 
VV 


V 
V 


OAOoRWNNFA 
mmm oon — 01 o1 


37 
45 
75 
2 1 
>3 F 
45 
6E 
6E 


V 
V 
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Assembler Syntax 
Operands | 


Execution 


Encoding 


Description 


Words. 
Cycles 
Repeatability 


Example 
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[<label>] RFSM 


-None 


(PC) +17 PC | 
0 ~ FSM status bit in status register ST1 


Affects FSM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 
110014 1 41 0 0 04 14 0 14 4 0 


The RFSM status bit resets the FSM status bit to logic zero. In this mode, external 
FSR pulses are not required to initiate the receive operation for each word 
received, but rather only one FSR pulse is required to initiate a “continuous mode” 
of operation. The same holds true for FSX when TXM = 0. After the first FSR/FSX 
pulse, these inputs are then in a “don’t care” state. If TXM = 1, FSX is pulsed the 
first time DXR is loaded, but remains low thereafter. See Section 3.7 for further 


~~ details on the operation of the serial” port. FSM may also be loaded by the LSTT 7 


and SFSM instructions. 


1 
Class IV (1) 
Category C 


RFSM FSM is reset, putting the serial port 
in a mode of operation where frame 
synchronization pulses are not required. 
This allows a continuous bit stream to 
be transmitted or received without FSX/FSR 
pulses every 8/16 bits. 


RHM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Reset Hold Mode a = RHM 


[<label>] RHM 


None 


(PC) +1-7PC 
O ~ HM status bit in status register ST1 


Affects HM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 14 0 0 +1 1 1 0 0 0 1 1 1 0 O 0 


The RHM instruction resets the HM status bit to logic zero. In this mode, the 
TMS320C25 is not halted during the assertion of HOLD when executing from 
on-chip program memory (either RAM or ROM), but instead places its external 
buses in the high-impedance state and continues execution until an external 
access must be made. External access can mean (in addition to the normal 
connotation) the following conditions: 





MP/MC CNF PC 
0 0 PC 4096 
0 1 4096 < PC < 65279 
1 0 Any PC value (normal TMS32020-type 
hold mode) 
1 1 PC < 65279 


HM can also be loaded by the LST1 and SHM instructions. 


1 
Class IV (1) 
Category C 


RHM HM is reset, implementing the new 
TMS320C25 hold mode for on-chip program 
execution. 
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Assembler Syntax 


Operands 


Execution | 


Encoding 


Description 


Words 


Cycles 
Repeatability 


Example 
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[<label>] ROL 


None 


(PC) +17 PC 


(ACC(31)) 7 C 
(ACC(30-0)) ~ ACC(31-1) 
(C, before ROL) ~ ACC(0) © 


Affects C. 
Not affected by SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #90 
1 #1001 1 4 0 0 0 1 14 0 41 0 0 


The ROL instruction rotates the accumulator left one bit. The MSB is shifted into 
the carry bit, and the value of the carry bit from before the execution of the 


_ instruction is shifted intothe LSB. 


1 
Class IV (1) 
Category A 
ROL 
Before Instruction | oe After Instruction 
acc [1] [>B0001234 acc [1] [>60002469 
c Cc 





Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ROR 


None 


(PC) +17 PC 
(ACC(0)) > C 
(ACC(31-1)) ~ ACC(30-0) 
(C, before ROR) ~ ACC(31) 


Affects C. 

Not affected by SXM. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #90 
1140 0 14 4 4 0 0 0 4 141 0 #4 Q 1 

The ROR instruction rotates the accumulator right one bit. The LSB is shifted into 


the carry bit, and the value of the carry bit from before the execution of the 
instruction is shifted into the MSB. 


1 


Class IV (1) 
Category A 
ROR 
Before Instruction After Instruction 
acc [o] [>B0001234 acc [o] [>5800091A 
C Cc 
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~ROVM _ 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Wo rds 


Repeatability 


Example 
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Reset Overflow Mode ROVM 


[<label>] ROVM 


None 


(PC) +1 PC 


0 ~ OVM status bit in status register STO. 
Affects OVM 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #90 
1 #1001 1 4 0 0 0 0 0 0 0 1 #0 


The OVM status bit is reset to logic zero, which disables the overflow mode. If 


an overflow occurs with OVM reset, the OV (overflow flag) is set, and the over- 
flowed result is placed in the aecumulates OVM may also be loaded by the LST 
and mon instructions. : | 


1 


Glass 4V(44)- 


Category C 


ROVM The overflow mode bit OVM is reset, 
disabling the overflow mode on any 
subsequent arithmetic operations. 


RPT Repeat Instruction as Specified by Data Memory Value RPT 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] RPT <dma> 
[<label>] RPT {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP <s 7 


(PC) +17 PC 
(dma(7-0)) ~ RPTC 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 #90 


0 1 0 O 1 0 1 1 30: : Data Memory Address 
oO 1 0 01 0 1 1417 See Section 4.1 


The eight LSBs of the addressed data memory value are loaded into the repeat 
counter (RPTC). This causes the following instruction to be executed one time 
more than the number loaded into the RPTC (provided that it is a repeatable 
instruction). Interrupts are masked out until the next instruction has been 
executed the specified number of times. (Interrupts cannot be allowed during the 
RPT/next instruction sequence, because the RPTC cannot be saved during a 
context switch.) The RPTC counter is cleared on a RS. 


RPT and RPTK are especially useful for repeating instructions, such as BLKP, 
BLKD, IN, MAC, MACD, NORM, OUT, TBLR, TBLW, and others. 


1 


Class | (1) 
Category X 
RPT DAT127 (DP = 31) 
SFR 
or 
RPT * If current auxiliary register contains 4095. 
SFR 
Before Instruction After Instruction 
Data Data 
Memory Memory 
4095 4095 
ACC >12345678 acc [o| >12345 
C Cc 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


4-114 — 


[<label>] RPTK <constant> 


0< constant < 255 


(PC) +17 PC 


Constant ~ RPTC 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


110-0 1 0 1 4] 8-BiConstnt 


The 8-bit immediate value is loaded into the RPTC (repeat counter). This causes 
the following instruction to be executed one time more than the number loaded 
into the RPTC (provided that it is a repeatable instruction). Interrupts are masked 
out until the next instruction has been executed the specified number of times. 
(Interrupts cannot be allowed during the RPT/next instruction sequence because 
the RPTC cannot be saved during a context switch.) The RPTC is cleared on a 
RS. | | 


BLKD, IN, MAC, MACD, NORM, OUT, TBLR, TBLW, and others. 


1 

Class IV (1) 

Category X 

LRLK AR2,>200 Load AR2 with the address of X. 
LARP 2 

ZAC Clear the accumulator. 

MPYK O Clear the P register. 

RPTK 2 Repeat next instruction 3 times. 
SQRA ee Compute: X**2 4 Y#*2 2442. 

APAC 


RSXM Reset Sign-Extension Mode RSXM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] RSXM 


None 

(PC) +17 PC 

0 ~ SXM sign-extension mode status bit 
Affects SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 1 0 0 4 14 4 0 0 0 0 0 0 4 +4  O 


The RSXM instruction resets the SXM status bit to logic zero, which suppresses 
sign-extension on shifted data memory values for the following arithmetic 
instructions: ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SUB, and SUBT. 


The RSXM instruction affects the definition of the SFR instruction. SXM may 
also be loaded by the LST1 and SSXM instructions. 


1 
Class IV (1) 
Category C 


RSXM SXM is reset, disabling sign-extension on 
subsequent. instructions. 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 


Repeatability 


4-116 


4 


[<label>] RTC 


None 

(PC) +1 > PC 

O > TC test/control flag in status register ST1 
Affects TC. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 40 
11 0 014 1 4 0 0 0 14 141 0 0 41 0 


The TC (test/control) flag in status register ST1 is reset to logic zero. TC may also 
be loaded by the LST1 and STC instructions. 


Class IV (1) 
Category C 


RTC ~—s*‘TC:«<(test/control) flag is reset to logic zero. 





RTXM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Reset Serial Port Transmit Mode | RTXM 


[<label>] RTXM 


None 

(PC) +17 PC 

0 ~ TXM transmit mode status bit 
Affects TXM mode bit. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 1 0 0 14 14 4 0 0 0 4 0 0 0 0 90 


The RTXM instruction resets the TXM status bit, which configures the serial port 
transmit section in a mode where it is controlled by an FSX (external framing 
pulse). The transmit operation is started when an external FSX pulse is applied. 
TXM may also be loaded by the LST1 and STXM instructions. 


1 
Class IV (1) 
Category C 


RTXM TXM is reset, configuring FSX as an input. 


4-117 





Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
nepeatspy 


Example 
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[<label>] RXF 


None 


(PC) +17 PC 
QO > XF external flag pin and status bit 


Affects XF. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 
1 100% 1 100 000% 17 0 0 


The XF pin and XF status bit in status register ST1 are reset to logic zero. XF 
may also be loaded by the LST1 and SXF instructions. 


oie IV (1) 


Category C 


RXF XF pin and status bit are reset to logic zero. 





SACH Store High Accumulator with Shift SACH 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SACH <dma>,[<shift>] 
[<label>] SACH {*|*+|*-|"0+]*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


O < dma < 127 
O < next ARP <s 7 
0 < shift < 7 (defaults to 0) 


(PC) +1 >PC | 
16 MSBs of (ACC) x 28hift + dma 


Not affected by SXM. 
15 14 13 12 11 10 9 8 F 6 5 4 3 2 1 = #90 


O 1 1 #O 1| Shift | 0| Data Memory Address 
Oo 1 1 #O 1] — Shift | 1 See Section 4.1 


The SACH instruction copies the entire accumulator into a shifter. It then shifts 
this entire 32-bit number anywhere from 0 to 7 bits, and copies the upper 16 bits 
of the shifted value into data memory. The accumulator itself remains unaffected. 


1 


Class Ill (1) 

Category A 

SACH DAT10,2 (DP = 4) 

or 

SACH eo If current auxiliary register contains 522. 


Before Instruction | After Instruction 


C C 


Data Data 
Memory Memory >1082 
522 


522 
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SACL 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
~ Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 
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Store Low Accumulator with Shift ____ SACL 


[<label>] SACL <dma>,[<shift>] 
[<label>] SACL {*|*+|*-|*0+]*0-|*BRO+|*BRO-}[, <shift> <next ARP>]] 


O< dma < 127 | 
O < next ARP < 7 
0 < shift < 7 (defaults to 0) 


(PC) +1 7PC 
16 LSBs of (ACC) x 2shift + gma 


Not affected by SXM. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =0 


O 1 1 0 O | Shift =| 0] Data Memory Address 


Oo 1 #1 +O Of — Shift | 1. See Section 4.1 


The low-order bits of the accumulator, shifted left anywhere from 0 to 7 bits as 


specified by the shift code, are stored in data memory. The low-order bits are filled 
with zeros, and the high-order bits are lost. The accumulator itself is unaffected. 


1 
Class Ill (1) 


Category A 

SACL DAT LIS (DP = 4) 

or : 

SACL wi If current auxiliary register contains 523. 


Before Instruction After Instruction 


C C 


Data Data 
Memory Memory >8420 
523 523 





SAR 


Store Auxiliary Register _ 


SAR 





Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 


[<label>] SAR <AR>,<dma> 
[<label>] SAR <AR>,{*|*+|*-|"0+|*0-|"BRO+|*BRO-}[,<next ARP>] 


0 < dma 
0 < auxil 
O < next 


< 127 
lary register AR < 7 
ARP <7 


(PC) +17 PC 
(AR) ~ dma 


15 14 


Direct Auxiliary Data Memory Address 
Register 


13 12 11 10 9Q 


6 


0 1 1 1 0 Auxiliary 1 
Register 


The contents of the designated auxiliary register are stored in the addressed data 


memory | 


ocation. 


3. 2 1 0 


See Section 4.1 





When modifying the contents of the current auxiliary register in the indirect 
addressing mode, SAR ARn (when n = ARP) stores the value of the auxiliary 
register contents before it is incremented, decremented, or indexed by ARO. 


1 
Class III 
Category 


SAR 
or 


SAR ARO, * 


ARO 


Data 
Memory 
798 


LARP 
SAR 


ARO 


Data 
Memory 
1025 


(1) 
B 


ARO , DAT30 (DP = 6) 


Before Instruction 


>18 
ARO 
ARO, *O+ 


ARO 


Data 
Memory 
798 


ARO 


Data 
Memory 
1025 


If current auxiliary register contains 798. 


After Instruction 
>37 


>802 


V 
OO 
~ 


>401 


4-121 





Assembler Syntax 


Operands 


Execution 


Encoding 


Description | 


Words 
Cycles 
Repeatability 


Example 
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[<label>] SBLK . <constant> [, <shift>] 


16-bit constant 
0 < shift < 15 (defaults to 0) 


(PC) +2>PC 
(ACC) - [constant x 2shift} + Acc 


lf SXM = 1: 
Then -32768 < constant < 3276/7. 
If SXM = 0: 


Then 0 < constant < 65535. 
Affects C and OV; affected by OVM and SXM. 


15 1413 12 1110 9 8 7 6 5 4 321 0 








The immediate field of the instruction is subtracted from the accumulator. The 
result replaces the accumulator contents. SXM determines whether the constant 
is treated as a signed two’s-complement number. or as an unsigned number. The 
shift count is optional and defaults to zero. 


a 
Class V (2) 
Category X 
SBLK Big 
Before Instruction | After Instruction 
ACC S3F COEF ACC S38 F70EF 
C : C 


SBRK Subtract from Auxiliary Register Short Immediate SBRK 


Assembler Syntax [<label>] SBRK <constant> 


Operands O < constant < 255 
Execution (PC) +1 = PC 
AR(ARP) - 8-bit positive constant ~ AR(ARP) 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 =O 
o 111111 4 
Description The 8-bit immediate value is subtracted, right-justified, from the currently selected 


auxiliary register with the result replacing the auxiliary register contents. The 
subtraction takes place in the ARAU, with the immediate value treated as an 8-bit 
positive integer. 


Words 1 

Cycles Class IV (1) 

Repeatability Category X 

Example SBRK >FF (ARP = 7) 


Before Instruction After Instruction 


AR? AR? >FFO1] 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description | 


Words 
Cycles 
Repeatability 
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[<label>] .SC 


None 


(PC). 1 = PC: | 
1 > carry bit C in status register ST1 


Affects C. 


15 14 1312 1110 9 8 7 6 5 4 3 2 1 «0 
1 1 00147 1 00071 7 00 0 1 


The carry bit C in status register ST1 is set to logic one. The carry bit may also 
be loaded directly by the LST1 and RC instructions. 


4 
Class IV (1) 


Category C 
ea a a SEN Sr : ee 


SFL Shift Accumulator Left. | SFL 


Assembler Syntax [<label>] SFL 


Operands None 


Execution (PC) +1. > PC 
(ACC(31)) 7 C 
(ACC(30-0)) ~ ACC(31 -1) 
0 ~ ACC(0) 


Affects C. 
Not affected by SXM bit. 


Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 0 
1 1 0 oO 1 1 1 0 0 0 0 1 1 0 O 0 
Description The SFL instruction shifts the entire accumulator left one bit. 


The least-significant bit is filled with a zero, and the most-significant bit is shifted 
into the carry bit. Note that SFL, unlike SFR, is unaffected by SXM. 


Words 1 
Cycles Class IV (1) 
Repeatability Category A 
Example SFL 
Before Instruction After Instruction 
ACC >B0001234 ACC >60002468 
Cc CG 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Words 
Cycles 
Repeatability 


Example 1 


Example 2 
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[<label>] SFR 


None | 


(PC) +17 PC 
lf SXM = 0: 


Then (ACC(0)) 7 C 
(ACC(31-1)) ~ ACC (30-0) and 0 > Acc(s), 
lf SXM = 1: 
Then (ACC(0)) > 
(ACC(31-1)) > ACC(30- 0) and (ACC(31)) 3 “ACC(31). 


Affects C..° 
Affected by SXM bit. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 


1 1 0 0 74 141 41 0 O OF O 1 4 O ODO 1 


The | SFR instruction shifts ie accumulater right o one e bit. 


If SXM = 1, the instruction produces an arithmetic right shift. The sign bit (MSB) 
is unchanged and is also copied into bit 30. Bit 0 is shifted into the carry bit. 


If SXM = 0, the instruction produces a logical right shift. All of the accumulator 
bits are shifted by one bit to the right. The least-significant bit is shifted into the 
carry bit, and the most-significant bit is filled with a zero. 


1 
Class IV (1) 


Category A 
SFR (SXM=0) 
Before Instruction After Instruction 
ACC >B0001234 ACC [o] >5800091A 
Cc Cc 
SFR (SXM=1) 
ACC >B 0001234 acc [o] [>D800091A 
C c 


SFSM Set Serial Port Frame Sync Mode _ SFSM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SFSM 


None 


(PC) +17 PC 
1 ~ FSM status bit in status register ST1 


Affects FSM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 
1 17 0 O 14 14 141 O O O 4 41 O 1 1 1 


The SFSM instruction sets the FSM status bit to logic one. In this mode, an 
external FSR pulse is required for a receive operation, and an external FSX pulse 
is required if TXM = 0. lf TXM = 1, FSX pulses are generated in the normal manner 
every time the transmit shift register XSR is loaded. See Section 3.7 for details 
on the operation of the serial port. FSM may also be loaded by the LST1 and 
RFSM instructions. 


1 
Class IV (1) 
Category C 


SFSM FSM is set, putting the serial port ina 
mode of operation where frame synchronization 
pulses are required for each word to be 
transmitted or received. 
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~SHM 


Assembler Syntax 


Operands 


Execution 


Encoding. 


Description 


Words 
Cycles _ 


Repeatability © 


Example 
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Set Hold Mode SHM 


| [<label>] SHM 


None 


(PC) +17PC 
1 ~ HM status bit in status register ST1 


Affects HM. 


15 14 13 12 11 10 9 8 F 6 5 4 3 2 1 =O 
1 1 #0 OO 1 1 1 0 0 0 1 1 1 O O 1 


The SHM instruction sets the HM status bit to logic one. In this mode, the 
TMS320C25 is halted in the normal manner whenever HOLD is asserted, regard- 
less of the PC value or the state of the MP/MC pin. HM may also be loaded by 
the LST1 and RHM instructions. 


1 





Category C 


SHM HM is set, implementing the normal | 
(TMS32020-type) hold mode of operation. 


SOVM 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Set Overflow Mode — SOVM 


[<label>] SOVM 


None 


(PC) +1 > PC 
1 > overflow mode (OVM) status bit 


Affects OVM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
1 1 O O 1 1 1 0 0 0 0 0 0 90 1 1 


The OVM status bit is set to logic one, which enables the overflow (saturation) 
mode. If an overflow occurs with OVM set, the overflow flag OV is set, and the 
accumulator is set to the largest representable 32-bit positive (>/7FFFFFFF) or 
negative (>80000000) number according to the direction of overflow. OVM may 
also be loaded by the LST and ROVM instructions. 


1 
Class IV (1) 
Category C 


SOVM The overflow mode bit OVM is set, enabling 
the overflow mode on any subsequent 
arithmetic operations. 
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Assembier Syntax 


Operands 


Execution 


Encoding 


Description 


Words 


“Cycles? eee 


Repeatability 


Example 


az=a-? 
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[<label>] SPAC 


None 


(PC) +17 PC 


(ACC) - (shifted P register) ~ ACC 


Affects C and OV; affected by PM and OVM. 
Not affected by SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 = 90 
1 1 0 0 47 41 41 O 0, O O 141 O 1 1 0 


The contents of the P register, shifted as defined by the PM status bits, are 
subtracted from the contents of the accumulator. The result is stored in the 
accumulator. Note that SPAC is unaffected by SXM; the P register is always 
sign-extended. SPAC is a subset of LTS, MPYS, and SORS. 


Category B 
SPAC (PM = 0) 
Before Instruction | After Instruction 
ACC >3.C ACC >18 
C G 


SPH | Store High P Register a | SPH 


Assembler Syntax 
Direct Addressing: [<label>] SPH <dma> 
Indirect Addressing: [<label>] SPH {*|*+|*-|*0+]|*0-|*“BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
O < next ARP < 7 
Execution (PC) +17 PC 


(PR shifter output (31-16)) ~ dma 
Affected by PM. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 


Direct 0 1 1 1 1 1 0 1 Data Memory Address 
Indirect] O 1 1 14 #14 #1 40 141— See Section 4.1 


Description The high-order bits of the P register, shifted as specified by the PM bits, are stored 
in data memory. Neither the P register nor the accumulator are affected by this 
instruction. High-order bits are sign-extended when the right-shift by 6 mode is 
selected. Low-order bits are taken from the low P register when left-shifts are 


selected. 
Words 1 
Cycles Class Ill (1) 
Repeatability Category B 
Example SPH DAT3 (DP = 4, PM = 2) 
or 
SPH * If current auxiliary register contains 515. 


Before Instruction After Instruction 


p >FEO79844 P >FEO79844 


Data Data 
Memory >4567 Memory. >EO79 
515 515 
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PL | Store Low P Register SPL 


Assembler Syntax | | 
Direct Addressing: [<label>] SPL <dma> | 
indirect Addressing: [<label>] SPL {*|*+|*-|*0+|"0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP <7 
Execution (PC) +:4-=.PC 


(PR shifter output (15-0)) ~ dma 
Affected by PM. 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 «0 


Direct 0 1 1 1 1 1 0 O Data Memory Address 
Indirect} O 1 1 #1 #1 #1 +40 Of1. See Section 4.1 


in data memory. Neither the P register nor the accumulator are affected by this 
instruction. High-order bits are taken from the high P register when the right-shift 
by 6 mode is selected. Low-order bits are zero-filled when left-shifts are selected. 


Words 1 
Cycles Class Ill (1) 
Repeatability Category B 
Example | SPL DAT3 (DP = 4, PM = 2) 
or 
SPL * If current auxiliary register contains 515. 


Before Instruction After Instruction 


P >FEO079844 P >FEQ79844 
Data Data 
Memory >4567 | Memory >8440 


515 515 
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Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] SPM _  <constant> 


O < constant < 3 


(PC) +17 PC 
Constant ~ product register shift mode (PM) status bits 


Affects PM. 
15 14 13 12 11 10 9 8 JF 6 5 4 3 2 1 #0 


1 1 °0 01 1 1 0 0 0 0 0 1 Of PM | 


The two low-order bits of the instruction word are copied into the PM field of 
status register ST1. The PM status bits control the P register output shifter. This 
shifter has the ability to shift the P register output either one or four bits to the 
left or six bits to the right, or to perform no shift. The bit combinations and their 
meanings are shown below. 


PM ACTION 

00 No shift of multiplier output 

O1 Output left-shifted 1 place and zero-filled 

10 Output left-shifted 4 places and zero-filled 

11 Output right-shifted 6 places, sign-extended, and LSB bits lost. 


The left-shifts allow the product to be justified for fractional arithmetic. The 
right-shift by six bits has been incorporated to implement up to 128 multiply- 
accumulate processes without the possibility of overflow occurring. PM may also 
be loaded by an LST1 instruction. 


1 
Class IV (1) 
Category X 


SPM 3 Product register shift mode 3 is selected, 
causing all subsequent transfers from the 
product register to the ALU to be shifted 
to the right six places. 
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SQRA ___ Square and Accumulate Previous Product | SQRA 


Assembler Syntax 
Direct Addressing: [<label>] SQRA <dma> _ 
Indirect Addressing: [<label>] SQRA {*|*+|*-|"0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
0 < next ARP < 7 
Execution (PC) +17PC 


(ACC) + (shifted P register) > ACC 
(dma) > T register 
(dma) x (dma) > P register 


Affects C and OV; affected by PM and OVM. 
Encoding ss 445° 14«13~=«12 11:10 8 8 7 6 5 4 3 2 1 ~«~0 


Direct Oo oO 1 1 1 0 O 1 | 0: Data Memory Address 





Indirect] OO 1..1..1..0 0 1,1]. See Section4.1 =| |. 


Description The contents of the P register, shifted as defined by the PM status bits, are added 
to the accumulator. The addressed data memory value is then loaded into the T 
register, squared, and stored in the P register. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example SQRA DAT30 (DP = 6, PM = 0) 
or 
SORA * If current auxiliary register contains 798. 
Before Instruction After Instruction 
Data Data 
Memory > Memory > 


798 798 


> 


P >12C P 


— 
OO “TN 
— 

V 

m 

= nN mn 


ACC >1F4 ACC >320 


OLx< 
o[o] 
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” 


SQRS Square and Subtract Previous Product SQR 


Assembler Syntax 
Direct Addressing: [<label>] SQRS <dma> 
Indirect Addressing: [<label>] SQRS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) +17 PC 


(ACC) - (shifted P register) ~ ACC 

(dma) ~ T register 

(dma) x (dma) > P register 

Affects C and OV; affected by PM and OVM. 


Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 #1 =O 


Direct O 1 0 1 1 0 1 0 EO Data Memory Address 
Indirect] O 1 0 1 #1 #0 1 #«Of1, See Section 4.1 


Description The contents of the P register, shifted as defined by the PM status bits, are 
subtracted from the accumulator. The addressed data memory value is then loaded 
into the T register, squared, and stored into the P register. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example SORS DATS (DP = 6, PM = QO) 
or 
SORS * If current auxiliary register contains 777. 
Before Instruction After Instruction 
Data Data 
Memory >8 Memory 8 
777 777 


T >1124 T >8 


>190 


= 
O[=. 
V 
> V 


ACC >1450 ACC >12C0 
C 
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Assembler Syntax | 
Direct Addressing: 
Indirect Addressing: | 


Operands 

Execution 

Encoding 

| Direct 
Indirect 


Description 


__tn. the direct addressing mode, status register STO is always stored in page O... —.- 


[<label>] SST <dma> |. 
[<label>] SST {*|*+|*- "0+ |*0- |*“BRO+|*BRO- fs <next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(status register STO) ~ dma 


15 14 13 12 11 10 9 8 FJ 6 5 4 3 2 #1 = =O 


O81 1 1 1 0 O 0 | Data Memory Address 


Oo 





0 See Section 4.1 


Status register STO is stored in data memory. 


regardless of the value of the DP register. The processor automatically forces the 
page to be O, and the specific location within that page is defined in the 
instruction. Note that the DP register is not physically modified. This allows 


_ storage of the DP register in the data memory on interrupts, etc., in the direct 


Words 
Cycles 
Repeatability 


Example 
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addressing mode without having to change the DP. In the indirect addressing 


-mode, the data memory address is obtained from the auxiliary register selected. 


(See the LST instruction for more information.) 


The SST instruction can be used.to store status register STO after interrupts and 
subroutine calls. The STO contains the status bits: OV (overflow flag) bit, OVM 
(overflow mode) bit, INTM (interrupt mode) bit, ARP (auxiliary register pointer) 
bit, and DP (data memory page pomter) bit. The status bits are stored in the data 
memory word as follows: 


11 10 7 6 5 4 3 2 1 0 


Cane [ov Jove far’ 


Note that SST * may be used to store status register STO anywhere in data memory, 
while SST in direct mode is forced to page 0. 


1 

Class Ill (1) 

Category C | 

SST DAT96 (DP = don't care) 

or 

SST * If current auxiliary register contains 96. 


Before Instruction After Instruction 


Status See Status 
Register >A408 | Register >A408 


STO STO 


Data Data 
Memory 7 Memory >A408 
96 | | 96 





11 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 


Repeatability 


Example 


Direct 


Indirect 


Store Status Register ST1 T1 


[<label>] SST1 <dma> 
[<label>] SST1 {*|*+]|*-|*0+|*O-|"BRO+|*BRO- iL <next ARP>] 


QO < dma < 127 
QO < next ARP < 7 


(PC) +17 PC 
(status register ST1) ~ dma 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 


0 1 1 1 1 0 oO 1 Data Memory Address 
O17 141 1 1 0 0 141) See Section 4.1 


Status register ST1 is stored in data memory. 


In the direct addressing mode, status register ST1 is always stored in page O 
regardless of the value of the DP register. The processor automatically forces the 
page to be QO, and the specific location within that page is defined in the 
instruction. Note that the DP register is not physically modified. This allows the 
storage of the DP in the data memory on interrupts, etc., in the direct addressing 
mode without having to change the DP. In the indirect addressing mode, the data 
memory address is obtained from the auxiliary register selected. (See the LST1 
instruction for more information.) 


This instruction can be used to store status register ST1 after interrupts and 
subroutine calls. The ST1 contains the status bits: CNF (RAM configuration 
mode) bit, TC (test/control) bit, SXM (sign-extension mode) bit, C (carry) bit, 
HM (hold mode) bit, FSM (frame synchronization mode) bit, XF (external flag) 
bit, FO (serial port format), TXM (transmit mode) bit, ARB (auxiliary register 
pointer buffer), and PM (product register shift mode) bit. The status bits are stored 
in the data memory word as follows: 


13. 12 


Cans TenF [re [xo [11 [am [rom x [ro [ee 


Note that SST1 * may be used to store status register ST1 anywhere in data 
memory, while SST1 in direct mode is forced to page 0. 


1 

Class Ill (1) 

Category C 

SST1 DAT97 (DP = don't care) 

SST1 * If current auxiliary register contains 97. 


Before Instruction After Instruction 
Status Status 


Register >A7EO Register >A7EO 
ST1 | ST1 


Data Data 


Memory | > Memory >A7EO 
97 97 
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Assembler Syntax 
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[<label>] SSXM 


Operands None 
Execution (PC) + 1->PC 
| 1 > SXM status bit in status register ST1 
Affects SXM. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 ~~ 0 
110 0 1 1 141 0 0 0 0 0 0 14 4 = 1 
Description | The SSXM instruction sets the SXM status bit to logic 1, which enables sign- 
oO extension on shifted data memory values for the following arithmetic instructions: 
ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SUB, and SUBT. 
SSXM also affects the definition of the SFR instruction. SXM may also be loaded 
| ee the LST1 and RSXM instructions. 
aaa ag eco ea Be AN nea es eda tes cee a ae cepa see 
Cycles Class IV (1) 
Repeatability Category C 
Example SSXM_ SXM is set, enabling sign extension on 


subsequent instructions. 


sTC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


Set Test/Control Flag | TC 


[<label>] STC 


None 


(PC) +17 PC 
1 ~ TC test/control flag in status register ST1 


Affects TC. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 = 40 
1 1 0 0 14 14 141 O08 O08 O 41 41 O ODO 14 1 


The TC (test/control) flag in status register ST1 is set to logic one. TC may also 
be loaded by the LST1 and RTC instructions. 


1 
Class IV (1) 
Category C 


STC TC (test/control) flag is set to logic one. 
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STXM. 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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__ Set Serial Port Transmit Mode ; STXM 


[<label>] STXM 
None | 


(PC) + 17 PC 
1 ~ TXM status bit in status register ST1 


Affects TXM. 


15 14 13 12 11 10 9 8 7F 6 5 4 3 2 #1 =O 
1 1 OO O 1 14 4 0 0 0 141 0 0 0 0 1 


The STXM instruction sets the TXM status bit to logic 1, which configures the 
serial port transmit section to a mode where the FSX pin behaves as an output. 
A pulse is produced on the FSX pin each time the DXR register is loaded internally. 
The transmission is initiated by the negative edge of this pulse. TXM may also 
be loaded by the LST1 and RTXM instructions. If the FSM status bit is a logic 


zero and serial port operation has already started, the FSX pin will be driven low 


1 
Class IV (1) 
Category C 


STXM TXM is set, configuring FSX as an output. 


SUB Subtract from Accumulator with Shift SUB 


Assembler Syntax 
Direct Addressing: [<label>] SUB <dma>,[<shift>] 
Indirect Addressing: [<label>] SUB {*|*+]|*-|*0+|*0-|*BRO+|*BRO-}[,<shift>[,<next ARP>]] 


Operands O < dma < 127 
O < next ARP < 7 
O < shift < 15 (defaults to 0) 


Execution (PC) + 1. PC 
(ACC) - [(dma) x 28hift] > ACC 


lf SXM = 1: 
Then (dma) is sign-extended. 
If SXM = 0: 


Then (dma) is not sign-extended. 
Affects C and OV; affected by OVM and SXM. 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 O- 


Direct O O 0 1] Shift Data Memory Address 
Indirect O O 0 1} Shift | 1] See Section 4.1 


Description — The contents of the addressed data memory location are left-shifted and 
subtracted from the accumulator. During shifting, low-order bits are zero-filled. 
High-order bits are sign-extended if SXM = 1 and zero-filled if SXM = 0. The 
result is stored in the accumulator. 


Words 1 
Cycles Class | (1) 
Repeatability Category A 
Example SUB DAT80 (DP = 8) 
Or 
SUB - If current auxiliary register contains 1104. 
Before Instruction After Instruction 
Data Data 
Memory >11 Memory >11 
1104 1104 
ACC >24 ACC >13 
C C 
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SUBB a Subtract from Accumulator with Borrow SUBB 


Assembler Syntax 
Direct Addressing: [<label>] SUBB <dma> | 3 
Indirect Addressing: [<label>] SUBB {*|*+[*-|*0+/*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands 0 < dma < 127 
; 0 < next ARP < 7 
Execution (PC) 1. = PC 


(ACC) - (dma) - (G) > ACC 
| Affects C and OV; affected by OVM. 
Encoding 15 14 13 12 1110 9 8 7 6 5 4 3 2 1 40 


Direct O 1 0 O 1 1 1 1 Data Memory Address 
Indirect O 1 0 QO 1 1 1 Cee See Section 4.1 


manner (see Section 3.4.3). 


Words 1 
Cycles Class | (1) 
Repeatability Category B 
Example SUBB DAT5 (DP = 8) 
| or 
SUBB * If current auxiliary register contains 1029. 
Before Instruction After Instruction 
Data , — Data 


Memory Memory 

1029 1029 

aco sce [p] [SEFFFFFFE 
Cc | C 


In the above example, C is originally zeroed, presumably from the result of a 
previous subtract instruction that performed a borrow. Thus, 6 - 6 - (0) = -1 
was the effective operation performed, generating another borrow (and resetting 
carry again) in the process. 


The SUBB instruction can be used in performing multiple-precision arithmetic. 
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bit are subtracted from the accumulator. The carry bit is then affected in the normal 


SUBC 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Conditional Subtract | SUBC 


[<label>] SUBC <dma> 
[<label>] SUBC {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1 7PC 
(ACC) - [(dma) x 219] > ALU output 


lf ALU output > 0: 


Then (ALU output) x 2 + 1 7 ACC; 
Else (ACC) x 2 ~ ACC. 


Affects C and OV. 
Not affected by OVM (no saturation) or SXM. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 14 0 


QO 1 0 0 O 1 1 1) 0.) Data Memory Address 





1 See Section 4.1 


The SUBC instruction performs conditional subtraction, which may be used for 
division. The 16-bit dividend is placed in the low accumulator, and the high 
accumulator is zeroed. The divisor is in data memory. SUBC is executed 16 times 
for 16-bit division. After completion of the last SUBC, the quotient of the division 
is in the lower-order 16-bit field of the accumulator, and the remainder is in the 
high-order 16 bits of the accumulator. SUBC assumes the divisor and the divi- 
dend are both positive. 


If the 16-bit dividend contains less than 16 significant bits, the dividend may be 
placed in the accumulator left-shifted by the number of leading non-significant 
zeroes. The number of executions of SUBC is reduced from 16 by that number. 
One leading zero is always significant. 


Note that SUBC affects OV but is not affected by OVM, and therefore the accu- 
mulator does not saturate upon positive or negative overflows when executing 
this instruction. 


1 

Class | (1) 

Category A 

RPTK 15 

SUBC DAT2 (DP = 4) 

or 

RPTK 15 

SUBC * If current auxiliary register contains 514. 

Before Instruction After Instruction 

Data Data 

Memory Memory 
514 514 
ACC >44 ACC >20009 

C C 
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Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 


Indirect 


_Description  _—_. 


Words 
Cycles 
Repeatability 


Example 
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r<label>] SUBH <dma> 
[<label>] SUBH {*|*+|*-|*0+/*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +1->PC 
(ACC) - [(dma) x 219] > ACC 


Affects C and OV; affected by OVM. 


15 14 13 12 1110 9 8 7 6 56 4 3 2 1 «0 


0 1:0 0 0 1 0 Of odo. Data Memory Address 
O See Section 4.1 





16 bits of the accumulator. The 16 low-order bits of the accumulator are unaf- 
fected. The result is stored in the accumulator. The carry bit C is reset if the result 
of the subtraction generates a borrow; otherwise, C is unaffected. 


The SUBH instruction can be used for performing 32-bit arithmetic. 


4 


Class | (1) 
Category B 
SUBH _- DAT33 (DP = 6) 
or | 
SUBH * If current auxiliary register contains 801. 
Before Instruction After Instruction 
Data Data 


Memory >4 Memory 


801 


Ph 
Cc ‘ : 


C 


SUBK Subtract from Accumulator Short Immediate UBK 


Assembler Syntax [<label>] SUBK <constant> 


Operands O < constant < 255 


Execution (PC) +17 PC 
(ACC) - 8-bit positive constant ~ ACC 


Affects C and OV: affected by OVM. 
Not affected by SXM. 


Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 == 1 0 
1 1 0 0 4 1 0 1] 8-Bit Constant 
Description The 8-bit immediate value is subtracted, right-justified, from the accumulator with 


the result replacing the accumulator contents. The immediate value is treated as 
an 8-bit positive number, regardless of the value of SXM. 


Words 1 
Cycles Class IV (1) 
Repeatability Category X 
Example SUBK >12 
Before Instruction After Instruction 
Cc C 
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‘Subtract from. Low Accumulator 





Assembler Syntax 
Direct Addressing: [<label>] SUBS <dma> 
Indirect Addressing: [<label>] SUBS {*|*+|*-|*0+|*0- |*BRO+|*BRO- ae <next ARP>] 


Operands O < dma < 127 
~ QO < next ARP < 7 
Execution (PC) Tt = PC 


(ACC) - (dma) ~ ACC 


Affects C and OV; affected by OVM. 
Not affected by SXM. 


Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =#40 


Direct} 0 1 0 0 0 1 0 1/0) Data Memory Address _ 





Description The contents of the addressed data memory location are subtracted from the 
accumulator with sign-extension suppressed. The data is treated as a 16-bit 
unsigned number, regardless of SXM. The accumulator behaves as a signed 
number. SUBS produces the same result as a SUB instruction with SXM = 0 and 
a shift count of 0. 


Words 1 | 
Cycles Class | (1) 
Repeatability Category B 
Example SUBS DAT2 (DP = 16) 
or 
SUBS * If current auxiliary register contains 2050. 


Before Instruction After Instruction 
Data 


, Data 
Memory >FO003 Memory >FO003 
2050 2050 


Before Instruction After Instruction 
Acc >F 108 Acc 
C Cc 
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Subtract from Accumulator 


SUBT with Shift Specified by T Register SUBT 


Assembler Syntax 
Direct Addressing: 
~ Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 





[<label>] SUBT <dma> 
[<label>] SUBT {*|*+|*-|*0+[*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(ACC) - [(dma) x oT register(3-0)) + (ACC) 


lf SXM = 1: 
Then (dma) is sign-extended. 


If SXM = 0: 
Then (dma) is not sign-extended. 


Affects C and OV; affected by SXM and OVM. 
15 14 13 12 11 10 9 8 FY? 6 5 4 3 2 1 = 0 


O 1 0 O QO 4 1 0 | O- Data Memory Address 
1 1 0 — See Section 4.1 


The data memory value, left-shifted as defined by the four LSBs of the T register, 
is subtracted from the accumulator. The result replaces the accumulator contents. 
Sign-extension on the data memory value is controlled by the SXM status bit. 





1 

Class | (1) 

Category A 

SUBT DAT127 (DP = 4) 

or 

SUBT = If current auxiliary register contains 639. 
Before Instruction After Instruction 

Data Data 
Memory >6 Memory >6 


639 639 


>FF98 >FF98 


ACC >FDA5 ACC >F7A5 


— 
— 


Obs 
OL. | 
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SXF _ on. ect Set External Flag | __ SXF 
Assembler Syntax [<label>] SXF 


Operands None 


Execution (PC) +1 > PC os 
1 > external flag (XF) pin and status bit 


Affects XF. | 
Encoding 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


1 1 0 O 1 1 1 0 0 0 0 0 1 1 0 1 
Description The XF pin and the XF status bit in status register ST1 are set to logic 1. XF may 
also be loaded by the LST1 and RXF instructions. 
Words 1 
Cycles Class IV (1) 
Repeatability Category C 


example ee ee pan and status bie are Gee to 1ogie to 
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TBLR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 


Table Read | TBLR 


[<label>] TBLR <dma> : 
[<label>] TBLR {*|*+|*-|*0+|*0-|"BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17PC 
(PFC) ~ MCS 
(ACC(15-0)) > PFC 


While (repeat counter) 0: 
(pma, addressed by PFC) > dma, 
Modify AR(ARP) and ARP as specified, 
(PFC) + 1 > PFC, 
(repeat counter) - 1 > repeat counter. 


(pma, addressed by PFC) ~ dma 
Modify AR(ARP) and ARP as specified. 
(MCS) > PFC 


7 6 5 4 3 2 #1 #0 


Oo 


15 14 13 12 11 10 9 


© 


Direct O 1 QO 1 1 0 O Data Memory Address 


Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


Oo 1 01 1 0 0 Of1. See Section 4.1 


The TBLR instruction transfers a word from a location in program memory to a 
data memory location specified by the instruction. The program memory address 
is defined by the low-order 16 bits of the accumulator. For this operation, a read 
from program memory is performed, followed by a write to data memory. When 
in the repeat mode, TBLR effectively becomes a single-cycle instruction, and the 
program counter that contains the ACCL is incremented once each cycle. If the 
MP/MC pin is low at the time of execution of this instruction and the program 
memory address used is less than 4096, an on-chip ROM location will be read. 


1 

Class XI (4) 

Category A 

TBLR DAT6 (DP = 4) 

TBLR - If current auxiliary register contains 518. 


Before Instruction After Instruction 


Program Program 
Memory Memory ~3.06 
35 35 


Data Data 
518 : 518 


TBLW Table Write | | TBLW 


Assembler Syntax 
Direct Addressing: [<label>] TBLW <dma> : 
Indirect Addressing: [<label>] TBLW <7 el |*O+ |*0- *BRO+|"BRO- \[,<next ARP>] 


Operands 0 <dma < 127 

| O < next ARP < 7. 
Execution (PC) +17 PC 
| (PFC) ~ MCS 


(ACC(15-0)) > PFC 


While (repeat counter) # 0: 
(dma) ~ pma, addressed by PFC, 
Modify AR(ARP) and ARP as specified, 
(PFC) +1 > PFC, 
(repeat counter) - 1 ~ repeat counter. 


(dma) > pma, addressed by PFC, 


Modify AR(ARP) and ARP as specified. _ 


_ {MCS)>-PEC | 
Encoding 15 «14 °«13°«12 11:10 9 8 7 6 5 43 2 1 «0 


Direct O 1 O 1 1 0 Oo 1 0 | Data Memory Address 
Indirect ) 1 see Section 4.1 


Description | The TBLW instruction transfers a word in data memory to program memory. The 
data memory address is specified by the instruction, and the program memory 
address is specified by the lower half of the accumulator. A read from data memory 
is followed by a write to program memory to complete the instruction. When in 
the repeat mode, TBLW effectively becomes a single-cycle instruction, and the 
program counter that contains the ACCL is incremented once each cycle. If the 
MP/MC pin ts low at the time of execution of this instruction and the program 
memory address used is less than 4096, an on-chip ROM location will be 
addressed but not written to. 





Words 1 
Cycles Class XII (3) 
Repeatability Category A 
Example | TBLW DATS5 (DP = 32) 
TBLW * If current auxiliary register contains 4101. 
Before Instruction After Instruction 
Acc Acc 
Data ~mensnneen , Data 
Memory >4339 Memory >4339 
4101 4101 
Program Program | 
Memory Memory >4339 
599 599 
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TRAP software Interrupt TRAP 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] TRAP 


None 


(PC) + 1 > stack 
30 ~ PC 


Not affected by INTM; does not affect INTM. 


15 14 13 12 11 10 9 8 FV 6 5 4 3 2 #1 90 
1 1 O O 1 1 1 0 0 0 0 1 1 1 1 0 


The TRAP instruction is a software interrupt that transfers program control to 
program memory location 30 and pushes the program counter plus one onto the 
hardware stack. The instruction at location 30 may contain a branch instruction 
to transfer control to the TRAP routine. Putting the PC + 1 onto the stack enables 
an RET instruction to pop the return PC (points to instruction after the TRAP) from 
the stack. 


1 


Class VIII (3) 

Category X 

TRAP Control is passed to program memory 
location 30. PC + 1 is pushed onto 
the stack. 
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XOR_ 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 


Execution 


Encoding 
Direct 
Indirect 


Description ==> 


Words 
Cycles 
Repeatability 


Example 
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Exclusive-OR with Accumulator | | XOR 


[<label>] XOR <dma> 


[<label>] XOR {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


0 < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
(ACC(15-0)).XOR.dma ~ ACC(15-0) 
(ACC(31-16)) + ACC(31-16) 

Not affected by SXM. 


15 14 13 12 1110 9 8 7 6 5 4 3 2 #1 #0 


0 1 0 OO 1 1 0 0| 0) Data Memory Address 


0 See Section 4.1 





- The low half of the accumulator is exclusive-ORed with the contents of the  —_— 


addressed data memory location. The upper half of the accumulator is not affected 
by this instruction. 


1 

Class | (1) 

Category B 

XOR DAT127 (DP = 511) 

or 

XOR * If current auxiliary register contains 65535. 


Before Instruction After Instruction 


Data Data 
Memory >FOFO Memory >FOFO 


65535 65535 


C C 


XORK 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 


XOR Immediate with Accumulator with Shift XORK 


[<label>] XORK <constant>[,<shift>] 


16-bit constant 
O < shift < 15 (defaults to 0) 


(PC) +27 PC 
(ACC(30-0)).XOR.[constant x 2shift ] + ACC(30-0) 
(ACC(31)) ~ ACC(31) 


Not affected by SXM. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 =O 


110 1] sh [0 0 0 0 01 1 0 
16-Bit Constant 


The left-shifted 16-bit immediate constant is exclusive-ORed with the accu- 
mulator, leaving the result in the accumulator. Low-order bits below and high- 
order bits above the shifted value are treated as zeroes, thus not affecting the 
corresponding bits of the accumulator. Note that the most-significant bit of the 
accumulator is not affected, regardless of the shift code value. 


2 
Class V (2) 
Category X 
XORK >FFFF,8 
Before Instruction After Instruction 
ACC >12345678 ACC >12CBA978 
C Cc 
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ZAC 


Assembler Syntax 


Operands 


Execution 


Encoding 


Description 


Words 
Cycles 
Repeatability 


Example 
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Zero Accumulator _ _ZAC 


[<label>] ZAC 


None 


(PC) +1 PC 
0 > ACC 


15 14 13 12 11 10 9 8 7F7 6 5 4 3 2 1 =O 
1 1 0 0 714 0 141 0 0 0 0 0 0 0 0 0 


The contents of the accumulator are replaced with zero. The ZAC instruction has 
been implemented as a special case of LACK. (ZAC assembles as LACK 0.) 


1 
Class IV (1) 
Category X 


ZAC 


| Before Instruction After Instruction 


C C 


ZALH Zero Low Accumulator and Load High Accumulator ___ ZALH 


Assembler Syntax 
Direct Addressing: [<label>] ZALH <dma> 
Indirect Addressing: [<label>] ZALH {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


Operands O < dma < 127 
O < next ARP < 7 
Execution (PC) +17 PC 


0 > ACC(15-0) 
(dma) > ACC(31-16) 


Encoding 15 14 13 12 11 10 9 8 F 6 5 4 3 2 1: O 


Direct} 0 1 0 0 0 0 0 Of 0] Data Memory Address 
Indirect 0 See Section 4.1 


Description ZALH loads a data memory value into the high-order half of the accumulator. The 
low-order bits of the accumulator are zeroed. . 





ZALH is useful for 32-bit arithmetic operations. 


Words 1 
Cycles Class | (1) 
Repeatability Category C 
Example ZALH DAT3 (DP = 32) 
or 
ZALH * If current auxiliary register contains 4099. 
Before Instruction After Instruction 
Data Data 
Memory >3FO1 Memory >3F0O1 
4099 4099 
ACC >77F FFF ACC >3F010000 
C C 
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a Zero Low Accumulator, Load High Accumulator - 
ZALR ___with Rounding | ee | | ZALR 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 


Indirect 


tannin waiinnensnicrellin i 


Words 
Cycles 
Repeatability 


Example 
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[<label>] ZALR <dma> 
[<label>] ZALR {*|*+|*-|*0+/*0- |*BRO+|*BRO- }L,<next ARP>] 


0 < dma < 127 
O < next ARP s 7 


(PC) +17 PC 
>8000 ~ ACC(15-0) 
(dma) ~ ACC(31-16) 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 #0 


O 1 1 1 1 0 1 1] 0) Data Memory Address 


1 ~~ §ee Section 4.1 





~The ZALR instruction loads a data memory value into the high-order half of the = 


accumulator with rounding the value by adding 1/2 LSB; 1.e., the 15 low bits (bits 
0-14) of the accumulator are set to zero and bit 15 of the accumulator is set to 
one. 


ZALR is a derivative instruction from ZALH. 


1 

Class | (1) 

Category C 

ZALR DAT3 (DP = 32) 

or : | 

ZALR *~ If current auxiliary register contains 4099. 


Before Instruction After Instruction 


Data , Data 
Memory >3FO1 Memory >3F01 


4099 4099 


C C 


Zero Accumulator, Load Low Accumulator 
ZALS with Sign-Extension Suppressed __ZALS 


Assembler Syntax 
Direct Addressing: 
Indirect Addressing: 


Operands 
Execution 
Encoding 
Direct 
Indirect 


Description 


Words 
Cycles 
Repeatability 


Example 


[<label>] ZALS <dma> 
[<label>] ZALS {*|*+|*-|*0+|*0-|*BRO+|*BRO-}[,<next ARP>] 


O < dma < 127 
O < next ARP < 7 


(PC) +17 PC 
0 > ACC(31-16) 
(dma) ~ ACC(15-0) 


Not affected by SXM. 
15 14 13 12 11 10 9Q 6 5 4 3 2 1 9O 


8 7 
0 1 0 0 0 O QO 1 O4 Data Memory Address 
oO 1 0 0 0 00 4/1. See Section 4.1 


The contents of the addressed data memory location are loaded into the 16 
low-order bits of the accumulator. The upper half of the accumulator is zeroed. 
The data is treated as a 16-bit unsigned number rather than a two’s-complement 
number. Therefore, there is no sign-extension with this instruction, regardless 
of the state of SXM. (ZALS behaves the same as a LAC instruction with no shift 
and SXM = 0.) 


ZALS is useful for 32-bit arithmetic operations. 


1 

Class | (1) 

Category C 

ZALS DAT1 (DP = 6) 

or 

ZALS * If current auxiliary register contains 769. 


Before Instruction After Instruction 
Data 


Data 
Memory >F7FF Memory >F7FF 


769 769 


C C 
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5. Software Applications 


The TMS320C25 microprocessor/microcomputer design emphasizes overall speed, 
communication, and flexibility. Control signals and instructions provide block- 
memory transfers, communication with off-chip devices (both serial and parallel), 
and multiprocessing possibilities. The instructions are tailored to digital signal proc- 
essing tasks, providing single-cycle multiply/accumulates, adaptive filtering support, 
and many other features. There is also instruction support for floating-point, 
extended-precision, and logical processing. Increased throughput for many digital 
signal processing (DSP) applications is accomplished by the single-cycle 
multiply/accumulate instructions, two large on-chip RAM blocks, eight auxiliary 
registers with a dedicated arithmetic unit, a serial port, hardware timer, and single- 
cycle |/O. 


This section provides explanations of how to use the various TMS320C25 processor 
and instruction set features along with assembly language coding examples. More 
information about specific applications can be found in the book, Digital Signal 
Processing Applications with the TMS320 Family. 


Major topics discussed in this section are listed below. 


@ Processor Initialization (Section 5.1 on page 5-2) 


@ Program Control (Section 5.2 on page 5-4) 
Subroutines 
Software stack 
Timer operation 
Single-instruction loops 
Computed GOTOs 


@ Interrupt Service Routines (Section 5.3 on page 5-11) 
Context switching 
Interrupt priority 


@ Memory Management (Section 5.4 on page 5-15) 
Block moves 
Configuring on-chip RAM 
Using on-chip RAM for program execution 


@ Fundamental Logical and Arithmetic Operations (Section 5.5 on page 5-23) 
Status register effects 
Bit manipulation 


@ Advanced Arithmetic Operations (Section 5.6 on page 5-25) 
Overflow management 
Scaling 
Moving data 
Multiplication 
Division 
Floating-point arithmetic 
Indexed addressing 
Extended-precision arithmetic 


@ Application-Oriented Operations (Section 5.7 on page 5-42) 
Companding 
Filtering 
Fast Fourier Transforms (FFT) 
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Software Applications 


5.1 Processor Initialization 
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Prior to the execution of a digital siaael processing aisoninas it is necessary to 
initialize the processor. Generally, initialization takes place anytime the processor is 


_ reset. 


‘When reset is activated by applying a low level to the RS (reset) input for at least 


three cycles, the TMS320C25 terminates execution and forces the program counter 


; (PC). to zero. Program memory location 0 normally contains a B (branch) instruction 
in order to direct program execution to the system initialization routine. The hardware 


reset also initializes various registers and status bits. 


After reset, the processor should be initialized to meet the requirements of the system. 
Instructions should be executed that set up operational modes, memory pointers, 
NSIrUpts, and the remaining functions necessary to meet sytem requirements. 


To configure the processor after reset,. the following internal functions ‘should be 
peerage in aspen ee edge a ioc 


Memory-mapped registers 

Interrupt structure 

Mode control (OVM, SXM, HM, FSM, FO, TXM, PM) 
Memory control (CNF) 

Auxiliary registers and the auxiliary register pointer (ARP) 
Data memory page pointer (DP). 


The OVM (overflow mode), TC (test/control flag), and IMR (interrupt mask register) 
bits are not initialized by reset. The auxiliary register pointer (ARP), auxiliary register 
pointer buffer (ARB), and data memory page pointer (DP) are also not initialized 
by reset. 


Example 5-1 shows coding for initializing the TMS320C25 to the following machine 
state, in addition to the initialization performed during the hardware reset: 


@ = All interrupts enabled 
Overflow mode (OVM) disabled 
Data memory page pointer (DP) set to zero 
Auxiliary register pointer (ARP) set to seven © 
_ Internal memory filled with zero. 


Software Applications 


Example 5-1. Processor Initialization 


TITL ‘PROCESSOR INITIALIZATION' 

IDT "EXAMPLE ' 

DEF RESET, INTO, INT1, INT2 

DEF TINT, RINT, XINT,USER 

REF ISRO, ISR1,1ISR2 

REF TIME ,RCV,XMT, PROC 
A ) 
* PROCESSOR INITIALIZATION 
* RESET AND INTERRUPT VECTOR SPECIFICATION 
* BRANCHES FOR EXTERNAL AND INTERNAL INTERRUPTS 
* 

AORG >0000 
RESET B INIT ; RS- BEGINS PROCESSING HERE. 
* 
INTO B ISRO ; INTO- BEGINS PROCESSING HERE. 
INT1 B ISR1 ; INT1- BEGINS PROCESSING HERE. 
INT2 B ISR2 ; INT2- BEGINS PROCESSING HERE. 
* 

AORG »>0018 
TINT 8B TIME ; TIMER INTERRUPT PROCESSING. 
RINT B RCV ; SERIAL PORT RECEIVE PROCESSING. 
XINT B XMT ; SERIAL PORT TRANSMIT PROCESSING. 
* 
USER B PROC ; TRAP VECTOR PROCESSING BEGINS. 


* 


THE BRANCH INSTRUCTION AT PROGRAM MEMORY LOCATION O DIRECTS 
EXECUTION TO BEGIN HERE FOR RESET PROCESSING THAT INITIALIZES 
THE PROCESSOR. WHEN RESET IS APPLIED, THE FOLLOWING CONDITIONS 
ARE ESTABLISHED FOR THE STATUS AND OTHER INTERNAL REGISTERS: 


ARP OV OVM 1 INTM DP 
STO: XXX 0 X 1 1 XXXXXXXXX 


ARB CNF TC SXM C 11 HM FSM XF FO TXM PM 
STl: XXX 0 X 1 1 Ak L iL nu 0 0 00 


REGISTER ADDRESS DATA 
DRR >0000 XXXX XXXX XXXX XXXX 
DXR >0001 XXXX XXXX XXXX XXXX 
TIM >0002 PTL. DIAL AT 2a 
PRD >0003 ‘1111 $1111 1111 1111 
IMR >0004 1111 1111 11XX XXxXxX 
GREG >0005 1111 1111 0000 0000 


RESERVED XAINT RINT TINT INT2 INTL INTO 
IMR: VEL X X X X X X 


et + + ee He HF HF HF FE HF HF SE HK He HF HF HF HF HK HF F 


INIT ROVM DISABLE OVERFLOW MODE. 


LDPK 0 ; POINT DP REGISTER TO DATA PAGE 0O. 
LARP 7 ; POINT TO AUXILIARY REGISTER 7. 
LACK >3F ; LOAD ACCUMULATOR WITH >3F. 

SACL 4 ; ENABLE ALL INTERRUPTS VIA IMR. 
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Software Applications | 


ao a ae 


* INTERNAL DATA MEMORY INITIALIZATION. 
* ae ao ie 


» ZERO THE ACCUMULATOR. 


ZAC | 
LARK  AR7,>60 ; POINT TO BLOCK B2. 
RPTK 31 Oo | | 
SACL *+ ; STORE ZERO IN ALL 32 LOCATIONS. 
7 | 
LRLK  AR7,>200 ; POINT TO BLOCK BO. 
RPTK 255 | 
SACL  *+ ; ZERO ALL OF PAGE 4. 
RPTK 255 | 
SACL *+ | ; ZERO ALL OF PAGE 5. 
* 
; POINT TO BLOCK Bl. 
RPTK 255 
SACL  *+ ; ZERO ALL OF PAGE 6. 
RPTK 255 es 
SACL  *+ ; ZERO ALL OF PAGE 7. 


THE PROCESSOR IS INITIALIZED. THE REMAINING APPLICATION- 
~-DEPENDENT- 
NOW BE INITIALIZED. 

EINT ; ENABLE ALL INTERRUPTS. 


5.2 Program Control 


To facilitate the TMS320C25’s use in general-purpose high-speed processing, a 
variety of instructions are provided for software stack expansion, subroutine calls, 
timer operation, single-instruction loops, and external branch control. Descriptions 
and examples of how to use these features of the TMS320C25 are given in this 
section. 


5.2.1 Subroutines 
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The TMS320C25 has a 16-bit Program Counter (PC) and an eight-level hardware 
stack for PC storage. The CALL and CALA subroutine calls store the current contents 
of the program counter on the top of the stack. The RET (return from subroutine) 
instruction then pops the top of the stack to the program counter. 


Example 5-2 illustrates the use of a subroutine to determine the square root of a 
16-bit number. Processing proceeds in the main routine to the point where the square 
root of a number should be taken. At this point a CALL is made to the subroutine, 
transferring control to that section of the program memory for execution and then 
returning to the calling routine via the RET instruction when execution has 
completed. 
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Example 5-2. Subroutines 


* AUTOCORRELATION 
* 
* THIS ROUTINE PERFORMS A CORRELATION OF TWO VECTORS AND THEN 
* CALLS A SQUARE ROOT SUBROUTINE THAT WILL DETERMINE THE RMS 
* AMPLITUDE OF THE WAVEFORM. 
* 
AUTOC 
LAC ENERGY 
CALL SQRT 
SACL ENERGY 
* 
* SQUARE ROOT 
. | | 
* THIS SUBROUTINE DETERMINES THE SQUARE ROOT OF A NUMBER X THAT 
* IS LOCATED IN THE LOW HALF OF THE ACCUMULATOR WHEN THE ROUTINE 
* IS CALLED. THE FRACTIONAL SQUARE ROOT OF X IS TAKEN, WHERE 
* 0 < X < 1 AND WHERE 1 IS REPRESENTED BY >7FFF. THE RESULT IS 
* RETURNED TO THE CALLING ROUTINE IN THE ACCUMULATOR. 


+ 


SAVED STATUS REGISTER STO ADDRESS 
SAVED STATUS REGISTER ST1 ADDRESS 
NUMBER X WHOSE SQUARE ROOT IS TAKEN 
INTERMEDIATE ROOTS 

SQUARE ROOT OF X 


STO EQU >60 
ST1 EQU >61 
NUMBER EQU >62 
TEMPR EQU  >63 
GUESS EQU >64 
* 


me =e Se BW WS 


SORT SST STO SAVE STATUS REGISTER STO. 


BLZ SQRTLP 
LAC GUESS,3 
SACL GUESS 
SACL TEMPR 
LARK AR1,14 


IF YES, TAKE THE ROOT; 

IF NO, THEN REINITIALIZE. 

SET INITIAL GUESS TO >4000. 

SET FIRST INTERMEDIATE ROOT TO >4000. 
15 ITERATIONS 


SST1 ST1 ; SAVE STATUS REGISTER STI. 

LDPK 0 ; LOAD DATA PAGE POINTER = 0. 

SSXM ; SET SIGN-EXTENSION MODE. 

SPM 1 ; LEFT-SHIFT PR OUTPUT TO ACCUMULATOR. 
SACL NUMBER ; SAVE X. 

LARP AR1 ; INITIALIZE VARIABLES FOR SQUARE ROOT. 
LARK AR1,11 ; 12 ITERATIONS 

LALK >800 ; ASSUME X IS LESS THAN >200. 

SACL GUESS ; SET INITIAL GUESS TO >800. 

SACL TEMPR ; SET FIRST INTERMEDIATE ROOT TO >800. 
SACH ROOT ; SET SQUARE ROOT VALUE TO O. 

LAC NUMBER ; LOAD X INTO THE ACCUMULATOR. 

SBLK >200 ; TEST IF X IS LESS THAN >200. 


* 


* SQUARE ROOT LOOP 

* 

SQRTLP SQRA TEMPR 
ZALH NUMBER 


SQUARE TEMPORARY (INTERMEDIATE) ROOT. 
CHECK IF RESULT IS LESS THAN X. 


=e 60 


SPAC 

BLZ NEXTLP ; IF IT'S NOT, SKIP ROOT UPDATE. 
ZALH TEMPR ; IF IT IS, SET ROOT EQUAL TEMPR. 
SACH ROOT 
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NEXTLP LAC GUESS,15 ; SCALE DOWN GUESS BY 2 TO CONVERGE. 
SACH GUESS 
-ADDH ROOT 
SACH TEMPR 
BANZ SORTLP 


ADD CURRENT ROOT ESTIMATE. 
UPDATE TEMPORARY ROOT VALUE. 
REPEAT SPECIFIED NUMBER OF ITERATIONS. 


we ™O NO NO NO NO 


LAC ROOT LOAD THE ROOT OF X. 
LST1 STI RESTORE STATUS REGISTER ST1. 
LST STO RESTORE STATUS REGISTER STO. 


RET 


Hardware stack allocation involves its use in interrupts, subroutine calls, pipelined 
instructions, and the emulator (XDS). The TMS320C25 disables all interrupts when 
taking an interrupt trap. If interrupts are enabled more than one instruction before 
the return of the interrupt service routine, the routine can also be interrupted, thus 
using another level of the hardware stack. This condition should be considered when 
managing the use of the stack. When nesting subroutine calls, each call uses a level 
of the stack. The number of levels used by the interrupt must be remembered as well 


the stack for breakpoint/single-step operations. Given these constraints, the follow- 
ing listings describe possible allocations of the hardware stack levels: 


- 1 level suggested for emulator (XDS) stack 

- 1 level reserved for TRAP (software interrupt) instruction 
- 1 level reserved for interrupt service routines (ISR) 

- 5 levels available for subroutine calls. 

or: 


- 1 level suggested for emulator (XDS) stack 

- 1 level reserved for TRAP (software interrupt) instruction 
- 2 levels reserved for interrupt service routines (ISR) 

- 4 levels available for subroutine calls. 


When two levels are allocated for ISRs, the individual ISRs can utilize one level of 
subroutine calls or one level of interrupt nesting. 


5.2.2 Software Stack 


5-6 


Provisions have been made on the TMS320C25 for extending the hardware stack into 
data memory. This is useful for deep subroutine nesting or stack overflow protection. 


The hardware stack is accessible via the accumulator using the PUSH and POP 
instructions. Two additional instructions, PSHD and POPD, are included in the 
instruction set so that the stack may be directly stored to and recovered from data 
memory. | 


A software stack can be implemented by using the POPD instruction at the beginning 
of each subroutine in order to save the PC in data memory. Then before returning, 
a PSHD is used to put the proper value back onto the top of the stack. 


When the stack has seven values stored on it and two or more values are to be put 
on the stack before any other values are popped off, a subroutine that expands the 
stack is needed, such as shown in Example 5-3. In this example, the main program 
stores the stack starting location in memory in AR2 and indicates to the subroutine 
whether to push data from memory onto the stack or pop data from the stack to 
memory. If a ‘0’ is loaded into the accumulator before calling the subroutine, the 
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subroutine pushes data from memory to the stack. Ifa ‘1’ is loaded into the accu- 
mulator, the subroutine pops data from the stack to memory. 


Since the CALL instruction uses the stack to save the program counter, the subroutine 
pops this value into the accumulator and utilizes the BACC (branch to address 
specified by accumulator) instruction to return to the main program. This prevents 
the program counter from being stored into a memory location. The subroutine in 
Example 5-3 uses the BANZ (branch on auxiliary register not zero) instruction to 
control all of its loops. 


Example 5-3. Software Stack Expansion 


* THIS ROUTINE EXPANDS THE STACK WHILE LETTING THE MAIN 
* PROGRAM DETERMINE WHERE TO STORE THE STACK CONTENTS OR FROM 
* WHERE TO RECOVER THEM. | 
* 
STACK LARP 2 

LARK AR1,6 


USE AR2. 
LOAD COUNTER. 


BNZ PO ; IF POPD IS NEEDED, GOTO PO. 
POP ; ELSE, SAVE PROGRAM COUNTER. 
P PSHD e+ AR L ; PUT MEMORY IN STACK. 
BANZ P,*-,AR2 ; BRANCH TO P UNTIL STACK IS FULL. 
BACC ; RETURN TO MAIN PROGRAM. 
PO POP ; SAVE PROGRAM COUNTER. 
MAR ie ; ALIGN STACK POINTER. 
PO1 POPD w= ARL ; PUT STACK IN MEMORY. 
BANZ PO1,*-,AR2 ; BRANCH TO PO1 UNTIL SAVED. 
MAR ak ; REALIGN STACK POINTER. 
BACC ; RETURN TO MAIN PROGRAM. 


5.2.3 Timer Operation 


The TMS320C25 provides an on-chip timer and its associated interrupt to perform 
various functions at regular time intervals. By programming the period (PRD) register 
from 1 to 65,535 (>FFFF), a timer interrupt (TINT) can be generated every 2 to 
65,536 cycles, respectively. (A period register value of zero is not allowed.) 


Two memory-mapped registers are used to operate the timer. The timer (TIM) 
register, data memory location 2, holds the current count of the timer. At every 
CLKOUT1 cycle, the TIM register is decremented by one. The PRD register, data 
memory location 3, holds the starting count for the timer. When the TIM register 
decrements to zero, a timer interrupt (TINT) is generated. In the following cycle, the 
contents of the PRD register are loaded into the TIM register. In this way, a TINT is 
generated every (PRD + 1) cycles of CLKOUT1. 


The timer and period registers can be read from or written to on any cycle. The count 
can be monitored by reading the TIM register. A new counter period can be written 
to the PRD register without disturbing the current timer count. The timer will then 
start the new period after the current count is complete. If both the PRD and TIM 
registers are loaded with a new period, the timer begins decrementing the new period 
without generating an interrupt. Thus, the programmer has complete control of the 
Current and next periods of the timer. 


The TIM and PRD registers are both set to the maximum value on reset (>FFFF). 
The TIM register begins decrementing only after RS is de-asserted. If the timer is 
not used, TINT should be masked. The PRD register can then be used as a gener- 
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al-purpose data memory location. If TINT its used, the PRD and TIM registers should 
be programmed before unmasking the TINT. 


Example 5-4 shows the assembly code that implements the use of the timer to divide 
down the CLKOUT1 signal. To generate a 9600-Hz clock signal, the PRD register 
should be loaded with 520. In the timer interrupt service routine, the XF line is 
toggled. The XF output is also used as an input for BIO in this example. The output 
of XF will provide a 50-percent duty cycle clock signal as long as the main routine 
or other interrupt routines do not disable interrupts. Interrupts may be disabled by 
direct or implied use of DINT, or by executing instructions in the repeat mode. The 
value for the PRD register is calculated as follows: 


CLKOUT1/(PRD + 1) = 2 x frequency of signal 
10 MHz/(520 + 1) = 2 x 9600 Hz 


Assuming a 10-MHz CLKOUT1 frequency, the frequency of the divided signal is 


9597 Hz. 


* SETUP FOR INTERRUPT SERVICE ROUTINE. 
* 


LALK 520 
SACL DMA3 
LACK 8 

OR DMA4 
SACL DMA4 
EINT 


* I/O SERVICE ROUTINE. 
* 


TIME BIOZ SET1 
RXF 
EINT 
RET 
SETI SXF 
EINT 
RET 


5.2.4 Single-Instruction Loops 
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 e ™e “6 NO Te NO NO 


LOAD THE PERIOD REGISTER. 


ENABLE 
ENABLE 


THE TIMER INTERRUPT. 
INTERRUPTS. 


CHECK THE CURRENT XF STATE. 


XF WAS 
ENABLE 
RETURN 
XF WAS 
ENABLE 
RETURN 


HIGH; SET IT LOW. 
INTERRUPTS. 

TO INTERRUPTED CODE. 
LOW; SET IT HIGH. 
INTERRUPTS. 

TO INTERRUPTED CODE. 


When programming time-critical high-computational tasks, it is often necessary to 
repeat the same operation many times. For these cases, repeat instructions that allow 
the execution of the next single instruction N+1 times are provided. N is defined 
by an eight-bit repeat counter (RPTC), which is loaded by the RPT or RPTK 
instructions. The instruction immediately following is then executed, and the RPTC 


is decremented until it reaches zero. 


When using the repeat feature, the instruction being repeated is fetched only once. 
As a result, many multicycle instructions become single-cycle when repeated. This 
is especially useful for I/O instructions, such as TBLR/TBLW, IN/OUT, or 


BLKD/BLKP. 


Since the instruction is fetched and internally latched, the program bus can be used 
to fetch or write a second operand in parallel to operations using the data bus. With 
the instruction latched for repeated execution, the program counter can be loaded 
with a data address and incremented on succeeding executions to fetch data in 
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Example 5-5. 


successive memory locations. As an example, the MAC instruction fetches the 
multiplicand from program memory via the program bus. Simultaneous with the 
program bus fetch, the second multiplicand is fetched from data memory via the data 
bus. In addition to these data fetches, preparation is made for accesses in the 
following cycles by incrementing the program counter and by indexing the auxiliary 
register. TBLR is another example of an instruction that benefits from simultaneous 
transfers of data on both the program and data buses. In this case, data values from 
a table in program memory may be read and transferred to data memory. When 
repeated, the program overhead of reading the instruction from program memory 
must be executed only once, thus allowing the rest of the executions to operate in 
a single cycle. 


Programs, such as those implementing digital filters, require loops that execute in a 
minimum amount of time. Example 5-5 shows the use of the RPT or RPTK 
instructions. 


Instruction Repeating 


* THIS ROUTINE USES THE RPT INSTRUCTION TO SET UP THE LOOP COUNTER 
IN ONE CYCLE. THE FOLLOWING EQUATION IS IMPLEMENTED IN THIS 
ROUTINE: 


+ + 


X(I) x Y(TI) 


THIS ROUTINE ASSUMES THAT THE X VALUES ARE LOCATED IN ON-CHIP 
ROM, AND THE Y VALUES IN BLOCK Bl. WHEN REPLACING RPT NUM 
WITH RPTK 9, THE PROGRAM WILL EXECUTE THE SAME WAY. 


+ eee te He HF HH He HF 


SERIES LARP AR6 


LACK 9 SET COUNTER TO 9. 


SACL NUM ; (NUM) = 9. 

LRLK AR6,>300 ; POINT AT BEGINNING OF DATA. 

MPYK >0 ; CLEAR P REGISTER. 

ZAC ; CLEAR ACCUMULATOR. 

RPT NUM ; EXECUTE FOLLOWING INSTRUCTION 10 TIMES. 
MAC >600,*+ ; MULTIPLY AND ACCUMULATE; INCREMENT ARO. 
APAC 

RET ; RETURN TO MAIN PROGRAM. 


5.2.5 Computed GOTOs 


Processing may be executed in a time- and process-dependent or selected way. 
Following a specific time or data processing path may then result in selecting one 
of several processing options. 


A simple computed GOTO can be programmed in the TMS320C25 by using the 
CALA instruction. This instruction uses the contents of the accumulator as the direct 
address of the call. Thus, the call address can be computed ‘in the ALU, as shown 
in Example 5-6. . 
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Example 5-6. Computed GOTO 
| TASK CONTROLLER 


5-10 


ee eee eH He He HEH He SH 


= 
> 
4 
KH 


_.OVRSAM 


* 
TSKSEQ 


IDLE 
LAC 
SUB 
BGEZ 
LACK 


SACT 


ADLK 
TBLR 
LAC 
CALA 
B 


EQU 

DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


SAMPLE 


ONE 
OVRSAM 
15 


SAMPLE 
TSKSEQ 


TEMP 
TEMP 


WAIT .. 


$ 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
BDCLK2 
DUMMY 
OUT 
DECODE 
DEMODB 
DUMMY 
AGCUPT 
DUMMY 
BDCLK1 
DUMMY 
DUMMY 
DUMMY 


me Ne Ne Ne he Ne NO Ne Ne NO 


ws ™S8 “TS TSH VS WE WE WH WE We We We WE WH WE WE 


THIS MAIN TASK ROUTINE CONTROLS THE ORDER OF EXECUTION 

AND SCHEDULING OF TASKS. WHEN AN INTERRUPT OCCURS, THE 
INTERRUPT SERVICE ROUTINE IS EXECUTED TO PROCESS THE INPUT 
AND OUTPUT DATA SAMPLES. AFTER THE INTERRUPT SERVICE 
ROUTINE HAS COMPLETED, THE PROCESSOR BEGINS EXECUTION WITH 
THE INSTRUCTION FOLLOWING THE IDLE INSTRUCTION. THIS 
ROUTINE SELECTS THE TASK APPROPRIATE FOR THE CURRENT 
SAMPLE CYCLE, CALLS THE TASK AS A SUBROUTINE, AND BRANCHES 
BACK TO THE IDLE TO WAIT FOR THE NEXT SAMPLE INTERRUPT 
WHEN THE SCHEDULED TASK HAS COMPLETED EXECUTION. 


WAIT FOR SAMPLE INTERRUPT. 

FETCH SAMPLE COUNT VALUE. 
DECREMENT THE SAMPLE COUNT. 

TEST FOR END OF BAUD INTERVAL. 
INIT COUNT FOR NEW BAUD INTERVAL. 


_SAVE..NEW. COUNT VALUE. — 


ADD TASK TABLE BASE ADDRESS. 


‘READ SUBROUTINE TASK ADDRESS. 


LOAD ACCUMULATOR FOR TASK CALL. 
EXECUTE APPROPRIATE TASK. 


UNUSED CYCLE 

UNUSED CYCLE 

UNUSED CYCLE 

UNUSED CYCLE 

COMPUTE ENERGY E(11) 

UNUSED CYCLE 

COMMUNICATE WITH U-CONTROLLER 
DECODE/GET SCRAMBLED DIBIT 
DEMODULATE IN MIDDLE OF BAUD 
UNUSED CYCLE 
UPDATE AGC EVERY 3RD BAUD 
UNUSED CYCLE 

COMPUTE ENERGY E(3) 
UNUSED CYCLE 
UNUSED CYCLE 
UNUSED CYCLE 


bo bp PS 
PNW PU 
proud 


I 
© 
1 


OrRNW Bb U10O) ~1 0 
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5.3 Interrupt Service Routine 


Interrupts on the TMS320C25 are prioritized and vectored. When an interrupt occurs, 
the corresponding flag is set in the Interrupt Flag Register (IFR). If the corresponding 
bit in the Interrupt Mask Register (IMR) is set and interrupts are enabled (INTM=0), 
then interrupt processing begins. 


When the interrupt vector is loaded into the program counter, interrupts are disabled 
(INTM=1) and a branch is made to the appropriate routine via the branch instruction 
stored at the associated vector location. Since all interrupts are disabled, interrupt 
processing may proceed without further interruption unless the interrupt service 
routine (ISR) re-enables interrupts. 


Unless the interrupt service routines are simple |/O handlers, the processing in each 
ISR generally must assure that the processor context is preserved during execution. 
The context must be saved before executing the routine itself and restored when the 
routine is finished. A common routine or routines individualized for each interrupt 
may be used to secure the context of the processor during interrupt processing. 
Context switching is also useful for subroutine calls, especially when extensive use 
is made of the stack or auxiliary registers. Code examples of context switching and 
an interrupt service routine are provided in this section. 


5.3.1 Context Switching 


Context switching, commonly required when processing a subroutine call or inter- 
rupt, may be quite extensive or simple, depending on the system requirements. On 
the TMS320C25, the program counter is stored automatically on the hardware stack. 
If there is any important information in the other TMS320C25 registers, such as the 
status or auxiliary registers, these must be saved by software command. A stack in 
data memory, identified by an auxiliary register, is useful for storing the machine state 
when processing interrupts. 


Examples of saving and restoring the state of the TMS320C25 are given in Example 
5-7 and Example 5-8. Auxiliary register 7 (AR7) is used in both examples as the 
stack pointer. As the stack grows, it expands into lower memory addresses. The 
registers saved are the status registers (STO and ST1), accumulator (ACCH and 
ACCL), product register (PR), temporary register (TR), all eight levels of the hardware 
stack, and the auxiliary registers (ARO through AR6). 


The routines in Example 5-7 and Example 5-8 are protected against interrupts, 
allowing context switches to be nested. This is accomplished by the use of the 
MAR *- and MAR “+ instructions at the beginning of the context save and context 
restore routines, respectively. Note that the last instruction of the context save 
decrements AR7 while the context restore is completed with an additional increment 
of AR7. This prevents the loss of data if a context save or restore routine is interrupted. 
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Example 5-7. Context Save 


TETL ‘CONTEXT SAVE' 
DEF SAVE _ 


* CONTEXT SAVE ON SUBROUTINE CALL OR INTERRUPT. 


* ASSUME AR7 IS THE STACK POINTER AND AR7 = 128. 


SAVE LARP  AR7 - > (ARP) --> ARB, 7 --> ARP, AR7 = 128 
MAR ee ; : AR7 = 127 
* 
* SAVE THE STATUS REGISTERS. 
SST1 *— > ST1 --> (127), AR7 = 126 
SST *— ; STO --> (126), AR7 = 125 
* ; 
* SAVE THE ACCUMULATOR. 
_ SACH *— + ACCH --> (125), AR7 = 124 
— SACL Km ; ACCL--> (124), AR] = 
a ta ema eee ee ac ete ia e 
* SAVE THE P REGISTER. 
SPM 0 | > NO SHIFT ON PR OUTPUT 
SPH x ; PRH --> (123), AR7 = 122 
SPL *— ; PRL --> (122), ART = 121. 
* ; 
* SAVE THE T REGISTER. 
MPYK i ; PR = TR 
SPL *— ; TR --> (121), AR7 = 120 
* 
* SAVE ALL EIGHT LEVELS OF THE HARDWARE STACK. 
RPTK fi 7 | 
POPD *— >; TOS (8) --> (120), AR7 = 119 
* ; STACK(7) --> (119), AR7 = 118 
x ; STACK(6) --> (118), AR7 = 117 
* ; STACK(5) --> (117), AR7 = 116 
* y STACK(4) --> (116), AR7 = 115 
* ; STACK(3) --> (115), AR7 = 114 
* ; STACK(2) --> (114), AR7 = 113 
* ; BOS (1) --> (113), AR7 = 112 
* 
~* SAVE AUXILIARY REGISTERS ARO THROUGH AR6. 
SAR ARO,*-  ; ARO --> (112), AR7 = 111 
SAR AR1,*- ; ARO --> (111), AR7 = 110 
SAR AR2,*- > ARO --> (110), AR7 = 109 
SAR AR3,*- ; ARO --> (109), AR7 = 108 
SAR AR4,*- ; ARO --> (108), AR7 = 107 
SAR AR5,*-  ; ARO --> (107), AR7 = 106 
SAR AR6,*- ; ARO --> (106), AR7 = 105 


* SAVE IS COMPLETE. 


eee 


Software Applications 


Example 5-8. Context Restore 


TITL "CONTEXT RESTORE' | 
DEF RESTOR 
“ | 
* CONTEXT RESTORE AT THE END OF A SUBROUTINE OR INTERRUPT. 
* 
* ASSUME AR7 IS THE STACK POINTER AND AR7 = 105. 
- 
RESTOR LARP AR7 ; (ARP) --> ARB, 7 --> ARP, 
MAR * + : 
* 
* RESTORE AUXILIARY REGISTERS ARO THROUGH ARO. 
LAR AR6, *+ : (106) --> ARG, 
LAR AR5, *+ ; (107) --> ARS, 
LAR AR4,*+ ; (108) --> AR4, 
LAR AR3,*+ * (109) --> AR3, 
LAR AR2,*+ ; (110) <--> AR2, 
LAR AR1,*+ s (111) --> ARI, 
LAR ARO, *+ » (112) --> ARO, 
* 
* RESTORE ALL EIGHT LEVELS OF THE HARDWARE STACK. 
RPTK 7 
PSHD w+ > (113) --> BOS (1), 
; (114) --> STACK(2), 
> (115) --> STACK(3), 
» (116) --> STACK(4), 
» (117) --> STACK(5), 
> (118) --> STACK(6), 
; (119) --> STACK(7), 
7 (120) --> TOS (8), 


t+ te eee He HF HF He He FH HF He 


AR7 
AR7 


AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 


AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 
AR7 


THE RETURN PC IS NOW ON THE TOP OF THE STACK FOR THE 
RET INSTRUCTION. NOTE THAT THE LOWER 16 BITS OF THE 
P REGISTER MUST BE LOADED VIA THE T REGISTER AND THAT 
THE STACK POINTER IS POINTING AT THE VALUE TO BE LOADED 


IN THE T REGISTER. 


RESTORE THE LOW P REGISTER. 


MAR e+ ; SKIP T REGISTER, 
LT = ; (122) ==> TR, 
MPYK a ; (TR) --> PRL 

* 

* RESTORE THE T REGISTER. 
LT * + x (121). ==> TR, 
MAR <a ; SKIP P REGISTER LOW, 
LPH * ; (123) --> PRH, 

* 

* RESTORE THE ACCUMULATOR. 
ZALS a ; (124) --> ACCL, 
ADDH +4 7; (225). ==> ACCH, 

* 

* RESTORE THE STATUS REGISTERS. 
LST *+ ; (126) -> STO, 
LST1 *+ p CL 27): eo STL, 

* 

* RESTORE IS COMPLETE. 
EINT ; ENABLE INTERRUPTS. 
RET 


; RETURN TO INTERRUPTS OR 
; CALLING ROUTINE. 


AR7 
AR7 


AR7 
AR7 


AR7 


AR7 
AR7 


AR7 
AR7 


lou uv bob ad Weal 


105 
106 


107 
108 
109 
110 
111 
112 
113 


114 
115 
116 
Ly 
118 
119 
120 
121 


122 
121 


122 
123 


124 


125 
126 


127 
128 
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§.3.2 Interrupt Priority 


Example 5-9. 


Interrupts on the TMS320C25 are prioritized in hardware. This allows interrupts that 
occur simultaneously to be serviced in a prioritized order. Sometimes priority may 
be determined by frequency or rate of occurrence. An infrequent, but lengthy, inter- 
rupt service routine (ISR) might need to be interrupted by a more frequently occurring 
interrupt. In the routine of Example 5-9, the ISR for INT1 temporarily modifies the 


‘interrupt mask register (IMR) to permit interrupt processing when an interrupt on 


INTO (but no other interrupt) occurs. When the routine has finished processing, the 
IMR is restored to its enone) state. 


Interrupt Service Routine 


TITL "INTERRUPT SERVICE ROUTINE’ 
DEF ISR1 


REF IMR 
* 


--*-ENPERRUPT PROCESSING FOR EXTERNAL INTERRUPT INT1-. 


* 


* THIS ROUTINE MAY BE INTERRUPTED BY AN INTERRUPT FROM THE 


* EXTERNAL INTERRUPT INTO-, BUT NO OTHER. 
* 


ISR1 LARP  AR7 ; 7 --> ARP 
MAR *¥- AR7 = AR7 - 1 
SST1  *- ; ST1 --> *AR7, AR7 = AR7 - 1 
SST = ¥- ; STO --> *AR7, AR7 = AR7 - 1 
SACH — *- ; ACCH --> *AR7, AR7 = AR7 - 1 
SACL *- ; ACCL --> *AR7, AR7 = AR7 - 1 
LDPK 0 ; DP = 0 | 
PSHD IMR ; IMR --> TOS 
LACK >0001 ; MASK FOR INTO- | 
AND IMR ; MASK CURRENT IMR CONTENTS. 
SACL IMR ; ACC --> IMR 
EINT ; ENABLE INTERRUPTS. 

* 

* MAIN PROCESSING SECTION FOR ISR1. 

* " 
DINT ; DISABLE INTERRUPTS. 
LDPK 0 ; DP = 0 
POPD IMR ; TOS --> IMR 
LARP AR7 ; 7 --> ARP 
MAR = *+ AR7 = AR7 + 1 
ZALS  *+ ; *AR7 --> ACCL, AR7 = AR7 + 1 
ADDH *+ ; *AR7 --> ACCH, AR7 = AR7 + 1 
LST = *+ ; *AR7 --> STO, AR7 = AR7 + 1 
LST1 *+ ; *AR7 --> ST1, AR7 = AR7 + 1 
EINT ; ENABLE INTERRUPTS. 
RET | 
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5.4 Memory Management 


The structure of the TMS320C25’s memory map is programmable and can vary for 
each application. Instructions are provided for moving blocks of data or program 
memory, configuring a block of on-chip data RAM as program memory, and defining 
part of external data memory as global. Explanations and examples of moving, 
configuring, and manipulating memory are provided in this section. 


5.4.1 Block Moves 


Since the TMS320C25 directly addresses a large amount of memory, blocks of data 
or program code can be stored off-chip in slow memories and then loaded on-chip 
for faster execution. Data can also be moved from on-chip to off-chip for storage 
or for multiprocessor data transfers. 


The BLKD and BLKP instructions facilitate memory-to-memory block moves on the 
TMS320C25. The BLKD instruction moves a block within data memory as shown 
in Example 5-10. Data may also be transferred between data memory and program 
memory by means of the TBLR and TBLW instructions. The instructions IN and OUT 
are used to transfer data between the data memory and the I/O space. 


Example 5-10. Moving External Data Memory to Internal Data Memory with BLKD 


* THIS ROUTINE USES THE BLKD INSTRUCTION TO MOVE A BLOCK OF 
EXTERNAL DATA MEMORY (DATA PAGES 8 AND 9) TO INTERNAL BLOCK 
Bl (DATA PAGES 6 AND 7). 


+ + + 


MOVED LARP AR2 


LRLK AR2,>300 DESTINATION IS BLOCK Bl IN RAM. 


; 
RPTK 255 ; REPEAT NEXT INSTRUCTION 256 TIMES. 
BLKD >400, *+ ; MOVE EXTERNAL BLOCK TO BLOCK Bl. 
RET ; RETURN TO MAIN PROGRAM. 


For systems that have external program memory but no external data memory, BLKP 
can be used to move program memory blocks into data memory. Example 5-11 
demonstrates how to use the BLKP instruction. 


Example 5-11. Moving Program Memory to Data Memory with BLKP 


* THIS ROUTINE USES THE BLKP INSTRUCTION TO MOVE DATA VALUES 
* FROM PROGRAM MEMORY INTO DATA MEMORY. SPECIFICALLY, THE 

* VALUES IN LOCATIONS 2, 3, 4, AND 5 IN PROGRAM MEMORY ARE 

* MOVED TO LOCATIONS 512, 513, 514, AND 515 IN DATA MEMORY. 
* 


SET REFERENCE FOR INDIRECT ADDRESSING. 
LOAD BEGINNING OF BLOCK BO IN AR2. 
SET UP LOOP. 

PUT DATA INTO DATA RAM. 

RETURN TO MAIN PROGRAM. 


MOVEP LARP AR2 
LRLK AR2,512 
RPTK 3 
BLKP 22; et 
RET 
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Another method for transferring data from program memory into data memory makes 
use of the TBLR instruction. By using the TBLR instruction, a calculated, rather than 
predetermined, location of a block of data in program memory may be specified for 
transfer. A routine using this approach is shown in Example 5-12. 


Software Applications 





‘Example 5-12. Moving Program Memory to Data MOMONY: with TBLR ~ 


+ Fe HE HF He F 


THIS ROUTINE USES THE TBLR INSTRUCTION TO MOVE DATA VALUES 
FROM PROGRAM MEMORY INTO DATA MEMORY. BY USING THIS ROUTINE, 
THE PROGRAM MEMORY LOCATION IN THE ACCUMULATOR FROM WHICH 
DATA IS TO BE MOVED TO A SPECIFIC DATA MEMORY LOCATION CAN 
BE SPECIFIED. ASSUME THAT THE ACCUMULATOR CONTAINS THE 
ADDRESS IN PROGRAM MEMORY FROM WHICH TO TRANSFER THE DATA. 


TABLER LARP ARS 


LRLK AR5,380 DESTINATION ADDRESS = PAGE 7. 


RPTK 127 ; TRANSFER 128 VALUES. 
TBLR le ; MOVE DATA INTO DATA RAM. 
RET ; 


RETURN TO CALLING PROGRAM. 


In cases where systems require that temporary storage be allocated in the program 


memory, TBLW can be used to transfer data from internal data memory to external = 
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“program memory. The code in Example 5-13 demonstrates how this may be 
accomplished. 


Example 5-13. Moving Internal Data Memory to Program Memory with TBLW 


e+ He + + HF He F 


-TABLEW LARP  AR6 


THIS ROUTINE USES THE TBLW INSTRUCTION TO MOVE DATA VALUES 
FROM INTERNAL DATA MEMORY TO EXTERNAL PROGRAM MEMORY. THE 
CALLING ROUTINE MUST SPECIFY THE DESTINATION PROGRAM MEMORY 
ADDRESS IN THE ACCUMULATOR. ASSUME THAT THE ACCUMULATOR 
CONTAINS THE ADDRESS IN PROGRAM MEMORY INTO WHICH THE DATA 
IS TRANSFERRED. 


LRLK  AR6,380 SOURCE ADDRESS = PAGE 7. 


RPTK 1 a ; TRANSFER 128 VALUES. 
TBLW w+ ; MOVE DATA TO EXTERNAL PROGRAM RAM. 
RET ; RETURN TO CALLING PROGRAM. 


The IN and OUT instructions are used to transfer data between the data memory and 
the I/O space, as shown in Example 5-14 and Example 5-15. 


Example 5-14. Moving Data from I/O Space into Data Memory with IN 


+e e+ + 


THIS ROUTINE USES THE IN INSTRUCTION TO MOVE DATA VALUES 
FROM THE I/O SPACE INTO DATA MEMORY. DATA ACCESSED FROM 
I/O PORT 15 IS TRANSFERRED TO SUCCESSIVE MEMORY LOCATIONS 
ON DATA PAGE 5. 


INPUT LARP AR2 


DESTINATION ADDRESS = PAGE 5. 
TRANSFER 64 VALUES. 

MOVE DATA INTO DATA RAM. 
RETURN TO CALLING PROGRAM. 


LRLK AR2,>2C0 
RPTK 63 
IN £PAI15,¥*+ 
RET 
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Example 5-15. Moving Data from Data Memory to I/O Space with OUT 


THIS ROUTINE USES THE OUT INSTRUCTION TO MOVE DATA VALUES 
FROM THE DATA MEMORY TO THE I/O SPACE. DATA IS TRANSFERRED 
TO I/O PORT 8 FROM SUCCESSIVE MEMORY LOCATIONS ON DATA 
PAGE 4. 


et Ft He F 


OUTPUT LARP AR4 


LRLK AR4,>200 SOURCE ADDRESS = PAGE 4. 


RPTK 63 ; TRANSFER 64 VALUES. 
OUT PAS, *+ ; MOVE DATA FROM DATA RAM. 
RET ; RETURN TO CALLING PROGRAM. 


5.4.2 Configuring On-Chip RAM 


The large amount of external memory and the configurability of on-chip RAM simplify 
the downloading of data or program memory into the TMS320C25. Also, since data 
in the RAM is preserved when redefining on-chip RAM, block BO can be configured 
dynamically as either data or program memory. Figure 5-1 illustrates the changes in 
on-chip RAM when switching configurations. 
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PROGRAM DATA _ a | MEMORY 
) BUS LOCATIONS 


MEMORY-MAPPED | 


DATA 0-5 
REGISTERS (>0000->0005) 





DATA 96-127 
BLOCK B2 (>0060->007F) 


DATA 512-767 
BLOCK 60 (>0200->02FF) 





(>0300->03FF) 





PROGRAM DATA MEMORY 
BUS BUS | LOCATIONS 


MEMORY-MAPPED 


DATA 0-5 
REGISTERS (>0000->0005) 


ee : 
38 : 
oe SACO cen BLOCK B2 DATA 96-127 
Ee as ; (>0060->007F) 
(i 2a) SC BLOCK BO 
DATA 768-1023 
soe (>0300->03FF) 


Figure 5-1. On-Chip RAM Configurations 
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PROGRAM -65,280-65,535 
(>FFOO—>FFFF) 


On-chip memory is configured by a reset or by the CNFD and CNFP instructions. 
Block BO is configured as data memory by executing CNFD or reset. A CNFP 
instruction configures block BO as program memory. 


Configuring block BO as program memory is useful for implementing adaptive filters 
or other similar applications at full speed with only on-chip memories. Example 5-16 


BLOCK B1 DATA 768-1023 
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illustrates the use of the configuration modes to utilize block BO as data and program 
memory while executing from on-chip program ROM. 


Example 5-16. Configuring and Using On-Chip RAM 


TITL 
DEF 
DEF 
* 
* 
* 
* 
* 
* 
COEFFP EQU 
COEFFD EQU 
* 
ONE EQU 
BETA  EQU 
ERR EQU 
ERRF  EOQU 
Y EQU 
X EQU 


FRSTAP EQU 
LASTAP EQU 
* 


"ADAPTIVE FILTER' 


ADPFIR 
X,Y 


>FFOO 
20200 


>7A 
>7B 
>7C 
>7D 
>7E 
> 71F 
>0380 
>O3FF 


=e 6™@ Se 68 lel M8 NO 


THIS 128-TAP ADAPTIVE FIR FILTER USES ON-CHIP MEMORY BLOCK 
BO FOR COEFFICIENTS AND BLOCK Bl FOR DATA SAMPLES. THE 
NEWEST INPUT SHOULD BE IN MEMORY LOCATION X WHEN CALLED. 
THE OUTPUT WILL BE IN MEMORY LOCATION Y WHEN RETURNED. 


BO PROGRAM MEMORY ADDRESS 
BO DATA MEMORY ADDRESS 


CONSTANT ONE (DP=6) 
ADAPTATION CONSTANT (DP=6) 


SIGNAL ERROR -(DP=6) 
ERROR FUNCTION (DP=6) 
FILTER OUTPUT (DP=6) 
NEWEST DATA SAMPLE (DP=6) 


NEXT NEWEST DATA SAMPLE 
OLDEST DATA SAMPLE 


* FINITE IMPULSE RESPONSE (FIR) FILTER. 


* 


ADPFIR CNFP 
MPYK 
LAC 

LARP 
LRLK 
RPTK 
MACD 
CNFD 
APAC 
SACH 
NEG 

ADD 

SACH 


FIR 


* 


LT 
MPY 
PAC 
ADD 
SACH 


LARP 
LARK 
LRLK 
LRLK 
DMOV 
LT 
MPY 


Q 

ONE, 14 

AR3 

AR3 ,LASTAP 
127 
COEFFP , *- 


Yop 


ERR,1 


ERR 
BETA 


ONE, 14 
ERRF,1 


AR3 
AR1,127 
AR2 , COEFFD 
AR3,LASTAP 
Xx 

ERRF 

*—, AR2 


e 
? 
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CONFIGURE BO AS PROGRAM: 
Clear the P register. 

Load output rounding bit. 
Point to the oldest sample. 


128-tap FIR filter. 
CONFIGURE BO AS DATA: 


Store the filter output. 


Add the newest input. 
err(n) = x(n) - y(n) 


LMS ADAPTATION OF FILTER COEFFICIENTS. 


128-TAP FIR FILTER. 
errf(n) = beta * err(n) 
ROUND THE RESULT. 


128 COEFFICIENTS TO UPDATE. 
POINT TO THE COEFFICIENTS. 
POINT TO THE DATA SAMPLES. 
INCLUDE NEWEST SAMPLE. 


P = 2*beta*err(n)*x(n-k) 
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ADAPT ZALR *,AR3 _; LOAD ACCH WITH ak(n) & ROUND. 


MPYA *=-,AR2 ; ak(nt+1) = ak(n) + P 

* ; P = 2*beta*err(n) *x(n-k) 
SACH *+,0,AR1 ; STORE ak(nt1). 
BANZ ADAPT,*-,AR2 ; END OF LOOP TEST. 


RET ; RETURN TO CALLING ROUTINE. 


5.4.3 Using On-Chip RAM for Program Execution 
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In using on-chip memory (block BO) for program execution, this memory must first 
be loaded with executable code from external memories while configured as data 
memory. On-chip execution is initiated by using the CNFP instruction to reconfigure 


address. By configuring block BO as program memory and executing from this 
internal memory, full-speed execution can be achieved in systems using slower 
external memory. Example 5-17 illustrates how a program may be written to be 
loaded into and executed from on-chip memory. | | 


One group of instructions, the branch/call instructions, are impacted by the location 
of execution. Normally, by using labels, the assembler properly determines the 
location to which a branch is taken. Since the code is relocated prior to execution 
from on-chip memory, it is necessary to alter the address determined by the assembler 
for branch instructions. This alteration is necessary so that the branch address that 
is determined can be consistent with the address space used during execution. In 
Example 5-17, this is accomplished by adding an offset value (OFFSET) to the 
branch label representing the destination address in the operand field for each branch 
instruction. The offset address is determined by use of an EQU (equate) directive 
that subtracts the assembler location of the code to be relocated (equivalent to base-0 
addressing) from the base address of the relocation address (internal block BO 
address in this case). | 
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Example 5-17. Program Execution from On-Chip Memory 


0 
INIT 


BRANCHES FOR EXTERNAL OR INTERNAL INTERRUPTS FOLLOW HERE AT 
THE DESIGNATED LOCATIONS AS REQUIRED. 


>20 


A BRANCH INSTRUCTION AT PROGRAM MEMORY LOCATION O DIRECTS 


PROCESSOR EXECUTION HERE. 


INITIALIZE THE PROCESSOR. 


AORG 
RESET B 
* 
* 
* 
* 
AORG 
* 
* 
x 
* 
* 
* 


4 
a 
tH 
re 


* 
* 


* 


ROVM 
SSXM 
LDPK 
SPM 

LARP 
LARK 
LALK 
SACL 
SACL 
ZAC 

SACH 


LOAD TIME-CRITICAL CODE 


LARP 
LRLK 
RPTK 
BLKP 


INITIALIZE 


LDPK 
LACK 
SACL 
LRLK 
RPTK 
BLKP 
CNFP 
LALK 
BACC 


AR4 
AR4,PRD 
PFFFF 
a4 

a4 


AR1 

AR1,BLKO 
PROGL-1 
PROG, *+ 


PARAMETERS 
6 


1 
ONE 


AR1,BLKO+PRGL 


COEFL-1 
COEF , *+ 


>FFOO 


me 06m™elhU|O8l6hU!O8lUCOUlUMCOHUMVCOCUMCOCUCUNMCOCUCUMOO CUP 


=e 6 68 68S 


FOR 
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DISABLE OVERFLOW MODE. 

SET SIGN EXTENSION. 

POINT DP REGISTER TO DATA MEMORY PAGE 0. 
NO SHIFT ON PRODUCT REGISTER OUTPUT. 

USE AUXILIARY REGISTER 4 (SET ARP = 4). 
POINT AR4 TO PERIOD REGISTER. 

SET ACCUMULATOR TO >FFFF. 

LOAD PERIOD REGISTER WITH MAXIMUM VALUE. 
ENABLE ALL INTERRUPTS VIA IMR. 

CLEAR ACCUMULATOR. 

CLEAR GREG TO MAKE ALL MEMORY LOCAL. 


FROM EXTERNAL SLOW MEMORY TO INTERNAL RAM. 


USE AUXILIARY REGISTER 1 (SET ARP = 1). 
POINT AR1 TO RECONFIGURABLE BLOCK BO. 

LOAD REPEAT COUNTER WITH BLOCK LENGTH. 
MOVE CODE FROM PROG MEMORY TO ON-CHIP RAM. 


EXECUTION. 


POINT DP REGISTER TO DATA MEMORY PAGE 6. 
SET ACCUMULATOR TO >0001. 

STORE VALUE OF 1. 

POINT AR1 TO INTERNAL MEMORY ADDRESS. 
LOAD REPEAT COUNTER WITH BLOCK LENGTH. 
MOVE DATA FROM PROG MEMORY TO ON-CHIP RAM. 
CONFIGURE BLOCK BO AS PROGRAM MEMORY. 
LOAD ACC WITH PROG ADDR IN INTERNAL RAM. 
BRANCH TO ON-CHIP EXECUTION ADDRESS. 
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* 


* 
PROG 


LPTS 


GET 


PROGE 
PROGL 
OFFSET EQU 
oe 


EQU 
BIOZ 


&B 


OUT 
IN 
LRLK 
ZAC 
MPYK 
RPTK 
MACD 
APAC 
SACH 
B 
EQU 
EQU 


* SIGNAL PROCESSING CODE TO BE EXECUTED FROM ON-CHIP RAM. 


GET+OFFSET : WAIT FOR INPUT SIGNAL. 
LPTS+OFFSET ; BRANCH IF NO SIGNAL. 
FILOUT,PA2 ; OUTPUT LAST FILTER OUTPUT. 

FILIN, PA2 : INPUT NEW SIGNAL SAMPLE. 
AR1,BLK1+SIGNAL; POINT AR1 TO SIGNAL DATA TO PROCESS. 
: CLEAR THE ACCUMULATOR. 

0 : CLEAR THE P REGISTER. 
15 : REPEAT MACD INSTRUCTION FOR 16 TAPS. 
>FFOO+COEFF,*- ; MULTIPLY/ACCUMULATE, SAMPLE DELAY. 
; ACCUMULATE THE LAST PRODUCT. 
FILOUT,1 : SAVE THE RESULT. 
LPTS+OFFSET : LOOP TO WAIT FOR NEXT SAMPLE. 
$ 
PROGE-PROG : PROGRAM CODE LENGTH. 
>FFOO-PROG : 


BASE ADDRESS OFFSET. 


* COEFFICIENT DATA TO BE LOADED INTO ON-CHIP RAM. 
* Le 


COEF 


COEFE 
COEFL 


* 


DATA 
DATA 
DATA 
DATA 
EQU 
EQU 


385,-1196,1839,-2009 
1390,407,-4403,19958 
19958 ,-4403,407,1390 
-2009,1839,-1196,385 


COEFE~-COEF ; COEFFICIENT DATA LENGTH. 


* INTERNAL MEMORY CONSTANTS. 


* 
BLKO 
BLK1 
* 


* DATA 


* 


DRR 
DXR 
TIM 
PRD 


| IMR 


GREG 
* 


* DATA 


* 


BO 


COEFF 
* 


* DATA 


* 


ONE 
FILOUT 
FILIN 
SIGNAL 


EQU 
EQU 


PAGE 


PAGE 


DORG 
BSS 
BSS 


PAGE 


DORG 
BSS 
BSS 
BSS 
BES 
END 


>200 
>300 
O (BLOCK B2) - DATA MEMORY LABELS. 
O ; 
1 ; SERIAL PORT DATA RECEIVE REGISTER. 
1 ; SERIAL PORT DATA TRANSMIT REGISTER. 
1 : TIMER REGISTER. 
1 ; PERIOD REGISTER. 
1 ; INTERRUPT MASK REGISTER. 
1 ; GLOBAL MEMORY ALLOCATION REGISTER. 
4 (BLOCK BO) - DATA MEMORY LABELS. 
0 
PROGL ; LOCATIONS FOR INTERNAL PROGRAM CODE. 
COEFL “+ LOCATIONS FOR COEFFICIENT MEMORY. 
6 (BLOCK Bl) - DATA MEMORY LABELS. 
0 
1 ; RESERVED FOR DATA VALUE OF 1. 
1 ; FILTER OUTPUT SIGNAL VALUE. 
1 ; FILTER INPUT SIGNAL VALUE. 
14 ; LAST SIGNAL DELAY VALUE. 
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5.5 Fundamental Logical and Arithmetic Operations 


Although the TMS$320C25 instruction set is oriented toward digital signal processing, 
the same fundamental operations of a general-purpose processor are included. This 
section explains basic operations of the TMS320C25’s Central Arithmetic Logic Unit 
(CALU), particularly accumulator operations, the status register effect on data 
processing, and bit manipulation. 


The TMS320C25 provides a complete set of logical operations, including AND, OR, 
XOR, and CMPL (complement) instructions. This enables the device to perform any 
logical function. These instructions may be used to perform sign magnitude to two’s 
complement or the reverse conversions. 


The contents of the accumulator may be stored in data memory using the SACH and 
SACL instructions or stored in the stack by using the PUSH instruction. The accu- 
mulator may be loaded from data memory using the ZALH and ZALS instructions, 
which zero the accumulator before loading the data value. The ZAC instruction zeroes 
the accumulator. POP can be used to restore the accumulator contents from the 
stack. 


The accumulator is also affected by the ABS and NEG instructions. ABS replaces 
the contents of the accumulator with the absolute value of its contents. NEG 
generates the arithmetic complement of the accumulator in two’s-complement form. 


5.5.1 Status Register Effect on Data Processing 


Three data processing options allow the ALU to automatically suppress sign exten- 
sion, manage overflow, or scale product accumulations. These options are enabled 
or disabled through bits in the status registers. These options function in parallel 
with normal execution of the instructions and cause no additional machine cycles, 
therefore no performance overhead. 


The sign-extension mode option is used to determine whether or not the shifted data 
values fetched for ALU operations should be sign-extended. The SXM status bit 
controls this operation. This bit is set to ‘1’ for enabling sign extension using the 
SSXM instruction, and set to ‘0’ for suppressing sign extension using the RSXM 
instruction. This operation affects all the instructions that include a shift of the 
incoming data value (i.e. ADD, ADDT, ADLK, LAC, LACT, LALK, SBLK, SFR, SUB, 
and SUBT). 


The overflow mode option is used to minimize the effects of an arithmetic overflow 
by forcing the accumulator to saturate at the largest positive value (or in the case 
of underflow, the largest negative value). The OVM status bit controls this operation. 
The overflow mode is enabled by setting the OVM bit to a ‘1’ using the SOVM 
instruction, and reset using the ROVM instruction. This feature affects all arithmetic 
operations in the ALU. 


The product register shift mode option forces all products to be shifted before they 
are accumulated. The products can be left-shifted one bit to delete the extra sign 
bit in the multiply of two 16-bit signed numbers. The products can be left-shifted 
four bits to delete the extra sign bits in multiplying a 16-bit data value by a 13-bit 
constant. The product shifter can also be used to shift all products six bits to the right 
to allow up to 128 product accumulations without the threat of an arithmetic over- 
flow, thereby avoiding the overhead of overflow management. The shifter can be 
disabled to cause no shift in the product when working with integer or 32-bit 
precision operations. This also maintains compatibility with TMS32010 code. These 
operations are controlled by the value contained in the PM bits of status register ST1. 
The PM bits are set using the SPM instruction. This feature affects all the instructions 
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that use the product of the multiplier (i.e, APAC, LTA, LTD, LTP, LTS, MAC, MACD, 
MPYA, MPYS, PAC, SPAC, SPH, SPL, SQRA, and SQRS). 


5.5.2 Bit Manipulation 


The BIT instruction tests any of the 16 bits of the addressed data word. The specified 
bit is copied into the TC of the status register. The bit tested is specified by a bit 
code in the opcode of the instruction. Either the BBZ (branch on TC bit = 0) or 
BBNZ (branch on TC bit = 1) instructions check the bit and allow branching to a 
service routine. 


Bit testing is useful in control applications where a number of states or conditions 
may be latched externally and read into the TMS320C25 via an IN instruction. At this 
point, individual bits can be tested and branches taken for appropriate processing. 


Since the BIT instruction requires the bit code to be specified with the instruction, 
it cannot be placed in a loop to test several different bits of a data word or bits 
determined by prior processing for efficient use. The TMS320C25 also has a BITT 
instruction in which the bit code is specified in the T register. Since the T register 
can easily be modified, BITT may be used to test all bits of a data word if placed 
within a loop or to test a bit location determined by past processing. 


Example 5-18. Using BIT and BBZ 


* THIS ROUTINE USES THE BIT INSTRUCTION TO TEST THE CONDITION 
* OF AN EXTERNAL MUX. BIT 4 DETERMINES THE UTILITY OF THE 
* REMAINING DATA. IF ZERO, A COUNTER IS INCREMENTED. IF ONE, 
* ADDITIONAL PROCESSING OCCURS AND THE COUNTER IS CLEARED. 
* THE ROUTINE IS INVOKED WHENEVER A TIMER INTERRUPT OCCURS. 
* 
TIME SST ~~ STO ; SAVE STATUS REGISTER STO. 

LDPK 0 

LARP AR6 

IN DAT,PA8 ; READ IN VALUE. 

BIT DAT,>B  ; TEST BIT 4. 

BBZ INCR ; BRANCH AND INCREMENT IF POSITIVE. 

LARK AR6,0 ; CLEAR THE COUNTER. 

LST STO ; RELOAD THE STATUS REGISTER. 

EINT ; ENABLE INTERRUPTS. 

RET ; RETURN TO INTERRUPTED ROUTINE. 
* 
INCR MAR #*+ ; INCREMENT THE COUNTER. 

LST STO ; RELOAD THE STATUS REGISTER. 

EINT ; ENABLE INTERRUPTS. 

RET ; RETURN TO INTERRUPTED ROUTINE. 
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Example 5-19. Using BITT and BBNZ 


* THIS ROUTINE USES THE BITT INSTRUCTION TO TEST THE CONDITION 
* OF AN EXTERNAL MUX. A BIT IN THE MUX IS SIGNIFICANT ONLY 
* WHEN PRIOR PROCESSING HAS DESIGNATED THE BIT TO BE ACTIVE. 
* INDIVIDUAL PROCESSING WILL TAKE PLACE BASED UPON THE STATE 
* OF THE TESTED BIT. THE BITS ARE TESTED EACH TIME A TIMER 
* INTERRUPT OCCURS. 
* 
TIME SST STO ; SAVE STATUS REGISTER STO. 

LDPK 0 

LARP AR5 

LAR AR5,BCNT ; LOAD COUNT OF ACTIVE BITS. 

LRLK AR6,BTBL ; LOAD THE BIT TABLE ADDRESS. 

IN DAT,PA8 ; READ IN VALUE. 

B LTEST, *-,6 
TMLOOP LT *+,5 ; LOAD BIT CODE. 

BITT DAT ; TEST SPECIFIED BIT. 


BBNZ LTEST ; BRANCH IF BIT IS ONE. 


LTEST BANZ TMLOOP,*-,6 


LST STO ; RELOAD THE STATUS REGISTER. 
EINT ; ENABLE INTERRUPTS. 
RET ; RETURN TO INTERRUPTED ROUTINE. 


5.6 Advanced Arithmetic Operations 


The TMS320C25 provides special instructions that facilitate efficient execution of 
arithmetic-intensive DSP algorithms, such as MACD, SQRA, SUBC, and NORM. 
Explanations and examples of how to use these instructions with overflow 
management, and for data moves, multiplications, division, floating-point arithmetic, 
indexed addressing, and extended-precision arithmetic are included in this section. 


5.6.1 Overflow Management 


The TMS320C25 has four features that can be used to handle overflow management. 
These include the branch on overflow conditions, accumulator saturation (overflow 
mode), product register right shift, and accumulator right shift. These features provide 
several options for overflow protection within an algorithm. 


A program can branch to an error handler routine on an overflow of the accumulator 
by using the BV (branch on overflow) instruction or bypass an error handler by using 
the BNV (branch if no overflow) instruction. These instructions can be performed 
after any ALU operation that may cause an accumulator overflow. 


The overflow mode is a feature useful for DSP applications. This mode simulates the 
saturation effect characteristic of analog systems. When enabled, any overflow in 
the accumulator results in the accumulator contents being replaced with the largest 
positive value (>7FFFFFFF) if the overflowed number is positive, or the largest 
negative value (>80000000) if negative. The overflow mode is controlled by the 
OVM bit of status register STO and can be changed by the SOVM (set overflow 
mode), ROVM (reset overflow mode), or LST (load status register) instructions. 
Overflows can be detected in software by testing the OV (overflow) bit in status 
register STO. When a branch is used to test the overflow bit, OV is automatically reset. 
Note that the OV bit does not function as a carry bit. It is set only when the absolute 
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5.6.2 Scaling 


value of a number is too large to be represented in the Seeumiulaioe: and it is not reset 


except by specific instructions. 


Another method of overflow management, which applies to multiply-accumulate 


Operations, is the use of the right shifter of the product register. The right shifter, 
which operates with no cycle overhead, allows up to 128 accumulations without the 
possibility of an overflow. The least-significant six bits of the product are lost, and 


the MSBs are filled with sign bits. This feature is initiated by setting the PM bits of 
status register ST1 to ‘11’ using the SPM or LST1 instructions. 


The TMS320C25 also has a right shift of the accumulator (using the SFR instruction) 
to scale down the accumulator when it nears overflow. 


Scaling the data coming into the accumulator or already in the accumulator is useful 
in signal processing algorithms. This is frequently necessary in adaptation or other 
algorithms that must compute and apply correction factors or normalize intermediate 
results. Scaling and normalizing are implemented on the TMS320C25 via right and 
left shifts in the accumulator and shifts of data on the incoming path to the accu- 
mulator. | 7 


Right and left shifts of the accumulator can be performed using the SFL and SFR 
instructions. SFL performs a logical left shift. SFR performs logical or arithmetic right 
shifts depending on the state of the SXM bit in the status register. A ‘1’ in the SXM 
bit, corresponding to sign-extension enabled, causes an arithmetic shift to be 
performed. 


In addition to the shift instructions, data can be left-shifted O to 15 bits when the 
accumulator is loaded using a LAC instruction, and left-shifted O to 7 bits when 
storing from the accumulator using SACH or SACL instructions. These shifts can 
be used for loading numbers into the high 16 bits of the accumulator and renor- 
malizing the result of a multiply. The incoming left shift of O to 15 bits can be supplied 
in the instruction itself or can be taken from the lowest four bits of the T register. 
Left shifts of data fetched from data memory are available for loading the accumulator 
(LAC/LACT), adding to the accumulator (ADD/ADDT), and subtracting from the 
accumulator (SUB/SUBT). The contents of the P register may also be shifted prior 
to accumulation. 


5.6.3 Moving Data 
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Many DSP applications must perform convolution operations or other operations 
similar in form. These operations require data to be shifted or delayed. The DMOV, 
LTD, and MACD instructions can perform the needed data moves for convolution. 


The data move function allows a word to be copied from the currently addressed 
data memory location in on-chip RAM to the next higher location while the data from 
the addressed location is being operated upon (e.g., by the CALU). The data move 
and the CALU operation are performed in the same cycle. In addition, an ARAU 
Operation may also be performed in the same cycle when using the indirect 
addressing mode. The data move function is useful in implementing algorithms, such 


as convolutions and digital filtering, where data is being passed through a time 
window. It models the z7 1 delay Operation encountered in those applications. The 
data move function is continuous across the boundary of the on-chip data memory © 
blocks BO, B1, and B2. However, the data move function cannot be used if off-chip 


memory is referenced. 
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In Example 5-20, the following equation is implemented: 


2 


Yin) = } HW) X(n-K) 
k=0 


where the H values stay the same, and the X values are shifted each time the 
microprocessor performs one of the following series of multiplications (similar to 
Operations performed in FIR filters): 


First Series: Y¥(2) = (HO)(X2)+(H1)(X1)+(H2) (XO) 
Second Series: Y(3) = (HO) (X3)+(H1)(X2)+(H2)(X1) | 
Third Series: Y(4) = (HO)(X4) +(H1)(X3) +(H2) (X2) 


The MACD instruction, which combines accumulate and multiply operations with a 
data move, is tailored to the type of calculation shown in the summation equation 
above. In order to use MACD, the H values have been stored in block BO, configured 
as program RAM, and the X values have been read into block B1 of data RAM as 
shown in Figure 5-2. 


PROGRAM DATA 
BLOCK BO BLOCK B1 
PC——»} H2 }——>FF00 + >300-—} x2 | 


ra >FFO1 >304 x1 
| HO >FFO2 >302 | xo | ARI 


(COEFFICIENTS) (SAMPLES) 


Figure 5-2. MACD Operation 


Also in Example 5-20, the summation in the above equation is performed in the 
reverse order, i.e., from K = 2 to 0, due to the operation of the data move function. 
This results in the oldest X value being used and discarded first. 


If the MACD instruction is replaced with the following two instructions, then the 
MAC instruction can be utilized with the same results. 


MAC * 
DMOV i= 


In cases where many more than three MACD instructions are required, the RPT or 
RPTK instructions may be used with MACD, yielding the same computational results 
but using less assembly code. 
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Example 5-20. omaing MACD for Moving Data 


FIR CNFP 


THIS ROUTINE IMPLEMENTS A SINGLE PASS OF A THIRD- ORDER FIR 
FILTER. IT IS ASSUMED THAT THE H AND X VALUES HAVE ALREADY 
BEEN LOADED INTO THEIR .RESPECTIVE MEMORY LOCATIONS, THAT 
THE ACCUMULATOR AND P REGISTER ARE BOTH RESET TO ZERO, AND 
THAT AR1 IS POINTING AT XO. NOTE THAT THE MACD INSTRUCTION 
MAY BE USED IN THE REPEAT MODE , BUT IT IS NOT IMPLEMENTED 
HERE. 


tee He HK 


CONFIGURE BLOCK BO AS PROGRAM MEMORY. 
AR1 SHOULD POINT AT THE X VALUES. 

P = (XO) (H2) 

ACC = (XO) (H2) 


LARP 1 
MAC >FFOO,*- 
MACD »>FFO1,*- 


=e ~e ™~e “S86 TSB NO TO BVO 


MACD >FFO2,* ‘ACC = (XO) (H2) + (X1) (HL) 

APAC ACC = (X0)(H2) + (X1)(H1) + (X2) (HO) 
CNFD CONFIGURE BLOCK BO AS DATA MEMORY. 
RET RETURN TO MAIN PROGRAM. 


5.6.4 Multiplication 


The TMS320C25 hardware multiplier normally performs two’s-complement 16-bit 
by 16-bit multiplies and produces a 32-bit result in one processor cycle. A single 
instruction, MPYU, can be used to multiply two 16-bit unsigned numbers. To 
multiply two operands, one operand must be loaded into the T register (TR). The 
second operand is moved by the multiply instruction to the multiplier, which then 
produces the product in the P register (PR). Before another multiply can be 
performed, the contents of the PR must be moved to the accumulator. A single- 


multiply program is shown in Example 5-21. By pipelining multiplies and PR moves, 


most multiply operations can be performed with a single instruction. 


A common operation in DSP algorithms is the summation of products. The MAC 
instruction, normally performed in four cycles, adds the contents of the PR to the 
accumulator and then simultaneously reads two values and multiplies them. When 
using the MAC instruction, a data memory value is multiplied by a program memory 
value. One of the operands can come from block B1 or B2 in on-chip data memory 
while the other operand. may come from block BO. Block BO must be configured as 


program memory when it supplies the second operand. Pipelining of the MAC 


instruction with a repeat instruction results in an execution time for each succeeding 
multiply-and-accumulate ‘operation of only one cycle. 


Example 5-21. Multiply 


9-28 


* THIS ROUTINE MULTIPLIES TWO VALUES IN DATA MEMORY LOCATIONS 
* >200 AND >201 WITH THE RESULT STORED IN >202 AND >203. 
te : 


MUL LRLK AR1,>200 POINT AT BLOCK BO. 


= me 


LARP 1 

LT la ; GET FIRST VALUE AT >200. 
MPY <P ; MULTIPLY BY VALUE AT >201. 
PAC ; PUT RESULT IN ACCUMULATOR. 
SACL - ; STORE LOW WORD AT >202. 
SACH ~ ; STORE HIGH WORD AT >203. 
RET ; RETURN TO MAIN PROGRAM. 


The pipelining of the MAC and MACD instructions incurs a certain amount of 
overhead in execution. In those cases where speed is more critical than program 
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memory, it may be beneficial to use LTA or LTD and MPY instructions rather than 
MAC or MACD. Example 5-22 and Example 5-23 show an implementation of 
multiply-accumulates using the MAC instruction and the LTA-MPY instruction pair, 
respectively. Figure 5-3 and Figure 5-4 provide graphically the information necessary 
to determine the efficiency of use for each of the techniques. 


Example 5-22. Multiply-Accumulate Using the MAC Instruction 


s Clock total clock program total program 
* cycles cycles memory memory 
_ | 

LARP ARI 1 1 

LRLK AR1,>300 2 2 

CNFP 1 1 

ZAC 1 1 

MPYK 0 1 1 

RPTK N-1 1 1 

MAC >FFOO,*+ 3 +N 2 

APAC 1 11 +N 1 10 


Example 5-23. Multiply-Accumulate Using the LTA-MPY Instruction Pair 


* clock total clock program total program 
* cycles cycles memory memory 
* 

ZAC 1 1 

LT D1 1 1 

MPY Cl 1 1 

LTA D2 1 1 

MPY C2 1 1 

2x wN 2x WN 

LTA DN 1 1 

MPY CN 1 1 

APAC 1 2 + 2N dl 2 + 2N 
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14 


EXECUTION IN CLOCK CYCLES 


no >» OD © 


eee 
oot) ©= LTA-MPY IMPLEMENTATION 
: ' x= BREAK-EVEN POINT 





12 3 4 5 6 7 8 9 110 11 


NUMBER OF MULTIPLY-ACCUMULATES TO BE 
PERFORMED 


Figure 5-3. Execution Time vs. Number of Multiply-Accumulates 
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14 


PROGRAM MEMORY IN WORDS > 
ND 


mo > D @® 


oe oe we 
‘ 
« 





123 4 5 6 7 8 9 


- @ = MAC IMPLEMENTATION 
> © = LTA-MPY IMPLEMENTATION 
: xX = BREAK-EVEN POINT 


10 11 


NUMBER OF MULTIPLY-ACCUMULATES TO BE 
PERFORMED 


Figure 5-4, Program Memory vs. Number of Multiply-Accumulates 


In numerical analysis, it is often necessary to square numbers along with adding or 
subtracting. The TMS320C25 has two instructions, SQRA and SQRS, that accom- 
plish this in a single machine cycle. The result of the previous operation in the PR 
is first added to the accumulator if SQRA is used, or subtracted from the accumulator 
if SORS is used. Then the data value addressed is squared, and the result is stored 
in the PR. Example 5-24 uses the SORA instruction to perform the computation. 


Example 5-24. Using SORA 


D* *2 = 


+ +t + F HF + 


DIST LAC 
SUB 


SACL 


LAC 
SUB 
SACL 


SQRA 
ZAC 

SQRA 
APAC 


RET 


XA 
XB 
XT 


YA 
YB 
YT 
XT 


Ya 


(XA - XB)**2 + (YA 


=e 6™ ee 6! 6S 


THIS ROUTINE USES THE SQRA INSTRUCTION TO COMPUTE THE 
SQUARE OF THE DISTANCE BETWEEN TWO POINTS WHERE D**2 
IS DEFINED AS FOLLOWS: 


- YB) **2 
XT = XA —- XB 
YT = YA — YB 
(P) = xT**2 
(ACC) = 0 
(P) = YT**2, (ACC) = XT**2 
(ACC) = XT*¥*2 + YT**2 = D**2 


RETURN TO MAIN PROGRAM. 
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When performing multiply-and-accumulate operations, it may be desirable to shift 
the product before adding it to the accumulator. This can be accomplished simul- 
taneously with the MAC instruction by using the product shift mode. This mode, 
controlled by two bits in the PM field of status register ST1, shifts the value from the 
PR while it is transferred to the accumulator. The contents of the PR are not shifted. 


5.6.5 Division 


5-32 


Division is implemented on the TMS320C25 by repeated subtractions using SUBC, 
a special conditional subtract instruction. Given a 16-bit positive dividend and 
divisor, the repetition of the SUBC command 16 times produces a 16-bit quotient 
in the low accumulator and a 16-bit remainder in the high accumulator. 


SUBC implements binary division in the same manner as is commonly done in long 
division. The dividend is shifted until subtracting the divisor no longer produces a 
negative result. For each subtract that does not produce a negative answer, ‘1’ is 
put in the LSB of the quotient and then shifted. The shifting of the remainder and 
quotient after each subtract produces the separation of the quotient and remainder 
in the low and high halves of the accumulator. 


There are similarities between long division and the SUBC method of division. Both 
methods are used to divide 33 by 5. 
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LONG DIVISION: 


00000000000001 10 Quotient 
0000000000000101 JOO000000000TOOO0T 
-101_ 
110 
-101 
11 Remainder 
SUBC METHOD: 
32 HIGH ACC COMMENT 


—LOw Ace _9 


0000000000000000 0000000000100001 
-10 _1000000000000000 
-10 04111111111011111 


| 
0000000000000000 0000000001000010 
-10 1000000000000000 


0000000000000100 0010000000000000 (14) 14th SUBC command. The resuit 
~10 4000000000000000 is positive. oa result left and 
0000000000000001 1010000000000000 replace LSB with ‘Tt. 
| 
0000000000000011 0100000000000001 (15) Result is again positive. Shift 
-10 1000000000000000 result left and replace LSB with ‘1’. 
| | 
0000000000000001 1000000000000011 (16) Last subtract. Negative answer, so 
-~10 1000000000000000 discard result and shift ACC left. 
0000000000000011 0000000000000110 Answer reached after 16 SUBC 
Instructions. 
| REMAINDER | | QUOTIENT 


(1) 


(2) 


Dividend is loaded into ACC. The 
divisor is left-shifted 15 and sub- 
tracted from ACC. The subtraction 
Is negative, so discard the result 
and shift left the ACC one bit. 


2nd subtract produces negative 
answer, so discard result and shift 
ACC (dividend) left. 


Note that since the condition of the divisor being less than the shifted dividend is 


determined by the sign of the result, both the dividend and divisor must be positive 
when using the SUBC command. Thus, the sign of the quotient must be determined 
and the quotient computed using the absolute value of the dividend and divisor. 


Integer and fractional division can be implemented with the SUBC instruction as 
shown in Example 5-25 and Example 5-26, respectively. When implementing a 
divide algorithm, it is important to know if the quotient can be represented as a 
fraction and the degree of accuracy to which the quotient is to be computed. For 
integer division, the absolute value of the numerator must be greater than the absolute 
value of the denominator. For fractional division, the absolute value of the numerator 
must be less than the absolute value of the denominator. 
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Example 5-25. Using SUBC for Integer Division 


* THIS ROUTINE IMPLEMENTS 


* 
DN1 


+  F 


DONE 


LT 
MPY 
PAC 
SACH 
LAC 
ABS 
SACL 
ZALS 


ABS 


IF DIVISOR 
HERE. 


RPTK 
SUBC 
SACL 
LAC 
BGEZ 
ZAC 
SUB 
SACL 
LAC 
RET 


NUMERA 
DENOM 


TEMSGN 
DENOM 


DENOM 
NUMERA 


AND DIVIDEND 


15 
DENOM 
QUOT 
TEMSGN 
DONE 


QuoT 
QUOT 
QuoT 


INTEGER DIVISION. 


3 GET SIGN OF QUOTIENT. 


; SAVE SIGN OF QUOTIENT. 


; MAKE DENOMINATOR POSITIVE. 
; ALIGN NUMERATOR. 


ARE ALIGNED, DIVISION CAN START 


; 16-CYCLE DIVIDE LOOP. 
; DONE IF SIGN IS POSITIVE. 


; NEGATE QUOTIENT IF NEGATIVE. 


; RETURN TO MAIN PROGRAM. 


Example 5-26. Using SUBC for Fractional Division 
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* THIS ROUTINE IMPLEMENTS 


* 
DN1 


+ + + 


DONE 





LT 
MPY 
PAC 
SACH 
LAC 
ABS 
SACL 
ZALH 
ABS 


IF DIVISOR 
HERE. 


RPTK 
SUBC 
SACL 
LAC 
BGEZ 
ZAC 
SUB 
SACL 
LAC 
RET 


NUMERA 
DENOM 


TEMSGN 
DENOM 


DENOM 
NUMERA 


AND DIVIDEND 


14 
DENOM 
QUOT 
TEMSGN 
DONE 


QuoT 
QUOT 
QuoT 


FRACTIONAL DIVISION. 


; GET SIGN OF QUOTIENT. 
; SAVE SIGN OF QUOTIENT. 


; MAKE DENOMINATOR POSITIVE. 
; ALIGN NUMERATOR. 


ARE ALIGNED, DIVISION CAN START 


; 15-CYCLE DIVIDE LOOP. 


; DONE IF SIGN IS POSITIVE. 


; NEGATE QUOTIENT IF NEGATIVE. 


| RETURN TO MAIN PROGRAM. 
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5.6.6 Floating-Point Arithmetic 


Floating-point numbers are often represented on microprocessors in a two-word 
format of mantissa and exponent. The mantissa is stored in one word. The exponent, 
the second word, indicates how many bit positions from the left the decimal point 
is located. If the mantissa is 16 bits, a 4-bit exponent is sufficient to express the 
location of the decimal point. Because of its 16-bit word size, the 16/4-bit float- 
ing-point format functions most efficiently on the TMS320C25. 


Operations in the TMS320C25’s central ALU are performed in two’s-complement 
fixed-point notation. To implement floating-point arithmetic, operands must be 
converted to fixed point for arithmetic operations, and then converted back to floating 
point. 


Conversion to floating-point notation is performed by normalizing the input data (i.e., 
shifting the MSB of the data word into the MSB of the internal memory word). The 
exponent word then indicates how many shifts are required. To multiply two float- 
ing-point numbers, the mantissas are multiplied and the exponents added. The 
resulting mantissa must be renormalized. (Since the input operands are normalized, 
no more then one left shift is required to normalize the result.) 


Floating-point addition or subtraction requires shifting the mantissa so that the 
exponents of the two operands match. The difference between the exponents is used 
to left-shift the lower power operand before adding. Then, the output of the add 
must be renormalized. 


TMS320C25 instructions useful in floating-point operations are the NORM, LACT, 
ADDT, and SUBT instructions. NORM (see Example 5-7) may be used to convert 
fixed-point numbers to floating-point. LACT may be used to convert back to 
fixed-point numbers. Addition and subtraction can be computed in floating point 
using ADDT and SUBT. 


Example 5-27 performs a floating-point multiply. The mantissas are assumed to be 
in Q15 format. Q15, one of the various types of Q format, is a number representation 
commonly used when performing operations on non-integer numbers. In Q format, 
the Q number (15 in 015) denotes how many digits are located to the right of the 
decimal point. A 16-bit number in Q15 format, therefore, has an assumed decimal 
point immediately to the right of the most significant bit. Since the most significant 
bit constitutes the sign of the number, then numbers represented in Q15 may take 
on values from +1 (represented by +0.9999999...) to -1 (represented by 
-0.9999999...). 
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Example 5-27. Using NORM for Floating-Point Multiply 


9-36 


++ + + HF He + HF HF HF HF HK KH HK OF 


THIS SUBROUTINE PERFORMS A FLOATING-POINT MULTIPLY USING 
THE NORM INSTRUCTION. THE INPUTS AND OUTPUTS ARE OF THE 
FORM: . 

C= MGS -242EC. | 
SINCE THE MANTISSAS, MA AND MB, ARE NORMALIZED, MC CAN BE 
NORMALIZED WITH A LEFT SHIFT OF EITHER O OR 1 IN THE 
ACCUMULATOR. THE EXPONENT OF THE RESULT IS ADJUSTED 
APPROPRIATELY. FOR EXAMPLE, MULTIPLICATION OF THE TWO 
NUMBERS A AND B, WHERE A = 0.1 * 2**2 AND B = 0.1 * 2**4, 
PROCEEDS AS FOLLOWS: 

1) A * B= 0.01 * 2**6 | 

2) A* B= O.L * 2¥**5 (NORMALIZED RESULT) 

MULT LAC EA | 

ADD ~~ EB > EC = EXPONENT OF RESULT BEFORE 

SACL EC + NORMALIZATION. 

LT MA 

MPY MB 

PAC > (ACC) = MA * MB 

‘ | 
SFL > TAKES CARE OF REDUNDANT SIGN BIT. 
LARP ARS5 


LAR AR5,EC AR5 IS INITIALIZED WITH EC. 


me 


NORM *- ; FINDS MSB AND MODIFIES ARS. 
SACH MC ; MC = MA * MB (NORMALIZED) 
SAR AR5,EC 

RET | + RETURN TO MAIN PROGRAM. 


Floating-point implementation programs often require denormalization as well as 
normalization to return results in a 16-bit format. Example 5-28 is tailored for 
denormalizing numbers that were normalized using the NORM instruction. This 
program assumes that the mantissa is in the accumulator and the exponent is in AR5, 
which is the format of the NORM instruction after execution. 
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Example 5-28. Using LACT for Denormalization 


* THIS ROUTINE DENORMALIZES NUMBERS NORMALIZED BY THE NORM 
* INSTRUCTION. THE DENORMALIZED NUMBER WILL BE IN THE 

* ACCUMULATOR. 

* 


DENORM LARP 1 ; USE AR1 TO POINT AT BLOCK BO. 
LRLK AR1,>200 
SAR ARS, *+ ; STORE EXPONENT AT >200. 
SACH *- ; STORE MANTISSA AT >201. 
* 
* SUBTRACT EXPONENT FROM 16 TO DETERMINE THE NUMBER OF SHIFTS 
* REQUIRED TO DENORMALIZE. 
* ' 
LAC * ; LOAD ACCUMULATOR WITH EXPONENT. 
BZ OUT ; CHECK FOR ZERO EXPONENT. 
Lt e+ 
LACT * ; DENORMALIZE NUMBER. 
RET ; RETURN TO MAIN PROGRAM. 
OUT MAR e+ ; POINT TO MANTISSA. 
ZALH * ; LOAD ACCUMULATOR WITH RESULT. 
RET ; RETURN TO MAIN PROGRAM. 


5.6.7 Indexed Addressing 


The Auxiliary Register Arithmetic Unit (ARAU) allows the the next indirect address 
to be calculated using increment/decrement calculations or indexed addressing in 
parallel to the current arithmetic operation. For example, in the multiplication of two 
matrices, the operation requires addressing across the rows (incrementing the address 
by one) or down the columns (incrementing by n). Example 5-29 gives the code for 
multiplying a row times a column of two 10 x 10 matrices. The first matrix resides 
in data RAM block B1, and the second matrix resides in block BO. 


Example 5-29. Row Times Column 


LARK 0O,>A ; SET INDEX TO 10. 

LARP 1 ; USE AR1 FOR ADDRESSING THE COLUMN. 

LRLK 1,>300 ; POINT AR1 TO THE START OF BLOCK Bl. 

CNFP ; SET BO TO PROGRAM ADDRESS FOR PIPELINING. 
ZAC ; INITIALIZE THE ACCUMULATOR. 

MPYK O ; CLEAR THE PRODUCT REGISTER. 

RPTK 9 ; REPEAT 10 TIMES AS DIMENSION OF MATRIX. 
MAC >FOOO,*0O+ ; MULTIPLY ROW ELEMENT TIMES COLUMN ELEMENT. 
APAC ; EXECUTE FINAL ACCUMULATION. 


ACCUMULATOR CONTAINS PRODUCT ELEMENT. 


The algorithm in Example 5-29 executes in 22 machine cycles. The key to this 
performance is the parallel addressing of both multiplicands simultaneously. The 
operation is made possible by the use of the data bus to fetch one multiplicand and 
the program bus to fetch the other. The auxiliary register indexes down the column 
of one matrix while the PC generates incremental addressing of each row of the other 
matrix. Each cycle of the repeat loop performs the following operations: 


1) Accumulates the previous product, 

2)  Multiplies the row element times the column element, 
3) Increments the row address, and 

4) Indexes the column address. 
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5.6.8 Extended-Precision Arithmetic 


5-38 





Numerical analysis, floating-point computations, or other operations may require 


arithmetic to be executed with more than 32 bits of precision. Two features of the 


TMS320C25 help to make extended-precision calculations more efficient. One of the 
features is the carry status bit. This bit is affected by all arithmetic operations of the 
accumulator (ABS, ADD, ADDH, ADDK, ADDS, ADDT, ADLK, APAC, LTA, LTD, 
LTS, MAC, MACD, MPYA, MPYS, NEG, SBLK, SPAC, SORA, SORS, SUB, SUBB, 
SUBC, SUBH, SUBK, SUBS, and SUBT). The carry bit is also affected by the rotate 


and shift accumulator instructions (ROL, ROR, SFL, and SFR) or may be explicitly 


modified by the load status register ST1 (LST1), reset carry (RC), and set carry (SC) 
instructions. For proper operation, the overflow mode bit should be reset (OVM=0) 
so that the accumulator results will not be loaded with the saturation value. Note that 
this means that some additional code may be required if overflow of the most 
significant portion of the result is expected. 


The carry bit is set whenever the addition of a value from the input scaling shifter 
or the P register to the accumulator contents generates a carry out of bit 31. Other- 
wise, the carry bit is reset since the carry out of bit 31 is a zero. One exception to this 
case is the ADDH instruction which can only set the carry bit. This allows the 
accumulation to generate the proper single carry when either the addition to the lower 
or upper half of the accumulator actually causes the carry. The following examples 
help to demonstrate the significance of the carry bit for additions: 


C MSB LSB C M&B LSB 

X FFFF FFFF ACC X FFFF FFFF ACC 
+ +F FFF FFFE 

1 0000 0000 1 FEFFE FFFE 

X 7FFF FFFF ACC X 7FEF FFFF ACC 
‘ 1 +F REEF FEEE 

0 8000 0000 1 TEFFE FEFE 

Xx 8000 0000 acc x 8000 0000 acc 
+ 1 +6 FP FF Pe 

0 8000 0007 1 TEFF FFFEF 

10000 0000 acc 1 FFFF FFFF ACC 
+s (ADDO) + 9s (ADD) 

0 D000 0001 1 0000 0000 

1 8000 FFFF ACC 18000 FFFF ACC 
+0000 0000 (ADDH) +7 FFE 0000 (ADDH) 

1 8000 FFEF 1 FFEFE FEFE 


Example 5-30 shows an implementation of two 64-bit numbers added to each other 
to obtain a 64-bit result. , 
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Example 5-30. 64-Bit Addition 


* TWO 64-BIT NUMBERS ARE ADDED TO EACH OTHER PRODUCING A 
* 6©4-BIT RESULT. THE NUMBERS X 


RCN 3 YD ly LO) 


+ + + * + 


ADD64 ZALH 
ADDS 
ADDS 
ADDH 
SACL 
SACH 
ZALH 
ADDC 
ADDS 
ADDH 
SACL 
SACH 
RET 


X3 X2 X1 XO 


+ Y3 Y2 Y1 YO 


ACC 
ACC 


=e “se oe WO 


ACC 


ACC 


; ACC 
ACC 


> 
OQ 
Q 


(X3;,X2,,%1,X%0) 
(W3,W2,W1,WO). 


ARE ADDED RESULTING IN W 


+++ 


AND Y 


OO YO 
Yl YO = Wl WO 


OO Y2 
VS Ve + 


xe 
Oa 


= W3 W2 


In a similar way, the carry bit is reset whenever the input scaling shifter or the P-re- 
gister value subtracted from the accumulator contents generates a borrow into bit 
31. Otherwise, the carry bit is set since no borrow into bit 31 is required. One 
exception to this case is the SUBH instruction which can only reset the carry bit. 
This allows the generation of the proper single carry when either the subtraction from 
the lower or upper half of the accumulator actually causes the borrow. The following 
examples help to demonstrate the significance of the carry bit for subtractions: 


C MSB 
Xx 00 


o FF 


x< 
~“ 
TN 


x< 
@ 
Oo 


7" 
7 


mo Oo 
\ 
“NiO © 
NO Oo 
THO O 
Ti © 


Example 5-31 provides the code for the implementation 


00 
FF 


FF 


F 


NO TN 
NOT 


00 


LSB 


Th 
mieke) ni © man no 


nO 
MO TN 


ACC 


ACC 


ACC 


ACC 


(SUBB) 


ACC 
(SUBH) 


subtracted to obtain a 64-bit number. 


omn 
ommn 
omn 


orn © 
orn oa 
orn © 


Tl 


orn © 
, ofne 


OT] © 
orto 


orn © 


LSB 
ACC 


orn o 
ome 
orn oe 
=/T11 © 


ACC 


onmn 
omn 
omn 


om 


ACC 


orn o 
ono 
orn © 
=/T10 


ACC 
(SUBB) 


mom 


ACC 
(SUBH) 


THO TN 
HO TN 
NOT 
ho TN 


of two 64-bit numbers 
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Example 5-31. 64-Bit Subtraction 


5-40 





* TWO 64-BIT NUMBERS ARE SUBTRACTED, PRODUCING A 64-BIT. 
* RESULT. THE NUMBER Y (Y3,Y2,Y1,Y0) IS SUBTRACTED FROM 


* 

* X3 X2 X1 XO 

* - ¥3 Y2 Y1 YO 

We 60 ——“it*t*t*tC Cl i ep i i tl 

* W3 W2 Wl WO 

‘ 7 | 

SUB64 ZALH xX1 ; ACC = X1 00 
ADDS xO ; ACC = X1 XO 
SUBS YO ; ACC = X1 XO - 00 
SUBH Yl ; ACC = X1 xO - Yl 
SACL woO 
SACH Wl 
ZALS X2 ; ACC = 00 X2 
SUBB Y2 ; ACC = 00 X2 - 00 
ADDH xX3 ; ACC = X3 X2 - 00 
SUBH Y3 ; ACC = X3 X2 - Y¥3 
SACL w2 
SACH W3 
RET 


The second feature of the TMS320C25 aiding in extended-precision calculations is 
the MPYU (unsigned multiply) instruction. The MPYU instruction allows two 
unsigned 16-bit numbers to be multiplied and the 32-bit result placed in the product 
register in a single cycle. Efficiency is gained by the ability to generate partial 
products from the 16-bit portions of a 32-bit or larger value instead of having to split 
the value into 15-bit or smaller parts. Example 5-32 shows an implementation of 


multiplying two 32-bit numbers to obtain a 64-bit result. 


* X (X3,X2,X1,X0) RESULTING IN W (W3,W2,W1,WO). 


YO 
YO 


W1 WO 
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Example 5-32. 32 x 32-Bit Multiplication 


* TWO 32-BIT NUMBERS ARE MULTIPLIED, PRODUCING A 64-BIT 
* RESULT. THE NUMBERS X (X1,X0) AND Y (Y1,Y0) ARE 


* MULTIPLIED RESULTING IN W (W3,W2,W1,W0O). 
* 


* X1 xO 

x Y1 YO 

rrr eg 

XO*YO 

* X1*YO 

* XO*Y1 

* X1*Y1 

a a a in css a Va a ues 

* W3 W2 W1 WO 

* 

* DETERMINE THE SIGN OF THE PRODUCT. 

* 

MPY32 ZALS X1 ; ACCL = SXXX XXXX XXXX XXXX 
XOR Yi ; ACCL = S--- ---- ---- ---- 
SACH SIGN ; SAVE THE PRODUCT SIGN 0=+, l=-. 


* 


* TAKE THE ABSOLUTE VALUE OF BOTH X AND Y. 
* 


ABSX ZALH X12 * ACC: = X1 00 
ADDS xO ACE = Xt XO 
ABS 
SACH X1 ; SAVE |X1]. 
SACL xO ; SAVE |XO|. 
ABSY ZALH Yl > ACC = Yi: 06 
ADDS YO ACE = V1. x0 
ABS 
SACH Yl ; SAVE |Y1|. 
SACL YO ; SAVE |YO|. 


* 


* MULTIPLY |X| AND |Y| TO PRODUCE |W]. 
* 


MULT LT xO ; T = xO 
MPYU YO ; T = XO, P = XO*YO 
SPL Wl ; SAVE |WO|. 
SPH wo ; SAVE PARTIAL |W1]. 
MPYU Y1 ; T = XO, P = XO*Y1 
LTP X1 ; T = X1, P = XO*Y1, ACC = XO*Y1 
MPYU YO > T = X1, P = X1*YO, ACC = XO*Y1 
ADDS W1 ; T = Xl, P = X1*YO, 
* ; ACC = XO*Y1 + XO*YO*2**-16 
MPYA Yl oP = Xi, P = K1eyi, 
* | ; ACC = X1*YO + XO*Y1 + XO*YO*2**-16 
SACL Wl ; SAVE |W1]|. 
SACH W2 ; SAVE PARTIAL |W2|. 
ZALS  W2 ; P = X1*Y1, 
* ; ACC = (X1*YO + XO*Y1)*2**-16 
BNC SUM ; TEST FOR CARRY FROM W2. 
ADDH ONE 
SUM APAC ; ACC = X1*Y1 + (X1*YO + XO*Y1)*2**-16 
SACL wW2 ; SAVE |W2]|. 
SACH W3 ; SAVE |W3]. 
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+ 


* TEST THE SIGN OF THE PRODUCT; NEGATE IF NEGATIVE. 
* : 7 i. 


LAC SIGN 


BZ DONE ; RETURN IF POSITIVE. 
* 
ZALH W1 ; ACC = |W1 00} 
ADDS wO ; ACC = |W1 WO| 
CMPL . | 
ADD ONE ; ACC = W1 WO AND CARRY GENERATION 
SACL wo ; SAVE WO. | 
SACH Wl ; SAVE Wl. 
ZALS  w2 ; ACC = |00 W2| 
ADDH W3 ; ACC = |W3 W2| 
CMPL 
ADDC ONE ; ACC = W3 W2 
SACL w2 > SAVE W2. 
SACH W3 ; SAVE W3. 


DONE RET 


5.7 Application-Oriented Operations 


The TMS320C25 has been designed to provide efficient implementations of many 
common digital signal processing algorithms. The architecture supporting these 
design features was discussed in Section 3. In general, the features provide efficient 
solutions to numerically intensive problems usually characterized by 
multiply/accumulates. Some device-specific features that aid in the implementation 
of specific algorithms are discussed in this section. 


5.7.1 Companding 
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Applications implemented on the TMS320C25 include filtering, FFTs, and more 
complex processes comprised primarily of filtering and FFTs. These applications 
require |/O performed either in parallel or serial. Hardware requirements for |/O are 
discussed in Sections 3 and 6. 


In the area of telecommunications, one of the primary concerns is the |/O bandwidth 
in the communications channel. One way to minimize this bandwidth is by 
companding. Two modes commonly used are A-law and yu-law companding. 
Detailed descriptions of companding are found in the application report available 
from Texas Instruments (see the book, Digital Signal Processing Applications with 
the TMS320 Family). | 


The technique of companding allows the digital sample information corresponding 
to a 13-bit dynamic range to be transmitted as 8-bit data. For processing in the 
TMS320C285, it is necessary to convert the 8-bit (logarithmic) sign-magnitude data 
to a 16-bit two’s-complement (linear) format. Prior to output, the linear result must 
be converted to the compressed or companded format. Table lookup or conversion 
subroutines may be used to implement these functions. 


In expanding from the 8-bit data to the 13-bit linear representation, table lookup is 
very effective since the table length is only 256 words. This is especially true for a 
microcomputer design since the TMS320C25 has 4K words of mask- programmable 
ROM. The table lookup technique requires three instructions (four words of program 
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memory), one data memory location, 256 words of table memory, and seven 
instruction cycles (program in on-chip ROM) to execute. 


LAC SAMPLE ; LOAD 8-BIT DATA. 
ADLK MUTABL ; ADD THE CONVERSION TABLE BASE ADDRESS. 
TBLR SAMPLE ; READ THE CORRESPONDING LINEAR VALUE. 


The above conversion could be programmed as a subroutine. This would eliminate 
the need for a table, but would increase execution time and require additional data 
memory locations. 


When the output data has been determined in a system transmitting companded data, 
a compression of the data must be performed. The compression reduces the data back 
to the 8-bit format. Unless memory for a table of length 16384 is acceptable, the table 
lookup approach must be abandoned for conversion routines. Details of these 
implementations may be found in the application report on companding. 


5.7.2 Filtering 


Digital filters are a common requirement for digital signal processing systems. The 
filters fall into two basic categories: Finite Impulse Response (FIR) and Infinite 
Impulse Response (IIR) filters. For either category of filter, the coefficients of the filter 
(weighting factors) may be fixed or adapted during the course of the signal proc- 
essing. The theory and implementation of digital filters has been presented and 
discussed in an application report (see the book, Digital Signal Processing Applica- 
tions with the TMS320 Family). The TMS320C25 reduces the execution time of 
all filters by virtue of its 100-ns instruction cycle time. 


IIR filters benefit from the 100-ns instruction cycle time of the TMS320C25. IIR 
filters typically require fewer multiply/accumulates. Correspondingly, the amount of 
data memory for samples and coefficients is not usually the limiting factor. Because 
of sensitivity to quantization of the coefficients themselves, IIR filters are usually 
implemented in cascaded second-order sections. This translates to instruction code 
consisting of LTDs and MPYs rather than MACDs. 


FIR filters also benefit from the faster instruction cycle time. In addition, an FIR filter 
requires many more multiply/accumulates than does the IIR filter with equivalent 
sharpness at the cutoff frequencies and distortion and attenuation in the passbands 
and stopbands. The TMS320C25 can help solve this problem by making longer filters 
feasible to implement. This is accomplished by allowing the coefficients to be fetched 
from program memory at the same time as a sample is being fetched from data 
memory. The simple implementation of this process uses the MACD instruction with 
the RPT/RPTK instruction. 


RPTK 255 
MACD *-,COEFFP 


The coefficients may be stored anywhere in program memory (reconfigurable on-chip 
RAM, on-chip ROM, or external memories). When the coefficients are stored in 
on-chip ROM or externally, the entire on-chip data RAM may be used to store the 
sample sequence. Ultimately, this allows filters of up to 512 taps to be implemented 
on the TMS320C25. Execution of the filter will be at full speed or 100 ns per tap 
as long as the memory supports full-speed execution. 


Up to this point, it has been assumed that the filter coefficients are themselves fixed. 
If the coefficients are adapted or updated with time, then another factor impacts the 
computational capacity. The second factor is the requirement to adapt each of the 
coefficients, usually with each sample. New instructions (MPYA or MPYS and ZALR) 
on the TMS320C25 aid with this adaptation to reduce the execution time. A means 
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of adapting the coefficients is the Least- Mean-Square (LMS) algorithm given by the 
following equation: 7 pt Xai, 


by, (i+1) = b.(l) + 2B e(i) x(l-k) 
where e(!) = x(I) — y(I) 


N-1 
and y(i) = 2 by x(i-k) 
k=0 


Quantization errors in the updated coefficients can be minimized if the result is 
obtained by rounding rather than truncating. For each coefficient in the filter at a 
given point in time, the factor 2*B*e(i) is a constant. This factor can then be 
computed once and stored in the T register for each of the updates. Thus, the 
computational requirement has become one multiply/accumulate plus rounding. 
Without the new instructions, the adaptation of each coefficient is five instructions 
corresponding to five clock cycles. This is shown in the following instruction 
sequence: 


LRLK AR2,COEFFD ; LOAD ADDRESS OF COEFFICIENTS. 
LRLK AR3,LASTAP ; LOAD ADDRESS OF DATA SAMPLES. 


LARP AR2 

LT ERRF - errf = 2*B*e(1i) 

ZALH * ,AR3 » ACC = bk(i)*2**16 

ADD ONE,15 > ACC = bk(i)*2**16 + 2**15 

MPY k—  AR2 

APAC * ACC = bk(i)*2**16 + errf*x(i-k) + 2**15 
SACH *+ ; SAVE bk(itl). 


e 


When the MPYA and ZALR instructions are used, the adaptation reduces to three 
instructions corresponding to three clock cycles, as shown in the following instruc- 
tion sequence. Note that the processing order has been slightly changed to incor- 
porate the use of the MPYA instruction. This is due to the fact that the accumulation 
performed by the MPYA is the accumulation of the previous product. 


LRLK AR2,COEFFD ; LOAD ADDRESS OF COEFFICIENTS. 
LRLK AR3,LASTAP ; LOAD ADDRESS OF DATA SAMPLES. 


LARP AR2 

LT ERRF ; errf = 2*B*e(i) 

ZALR *,AR3 ACC = bk(i)*2**16 + 2**15 

MPYA *-,AR2 ACC = bk(i)*2**16 + errf*x(i-k) + 2**15 


PREG = errf*x(i-k+1) 
SAVE bk(itl). 


=e “ee “Oe WE 


SACH *+ 


Example 5-33 shows a routine to filter a signal and update the coefficients. The total 
execution time of the routine is 33 + 4n where n is the filter length. Data and program 
memory requirements are 5 + 2n and 30 + 3n words, respectively. Note that for 
adaptive filters, the filter length is restricted both by execution time as well as memory. 
There is obviously more processing to be completed per sample due to the adaptation, 
and the adaptation itself dictates that the coefficients be stored in the reconfigurable 
block of on-chip RAM. Thus, the practical limit of an adaptive filter with no external 
data memory is 256 taps. 
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Example 5-33. 256-Tap Adaptive FIR Filter 


TITL 'ADAPTIVE FILTER’ 

DEF ADPFIR 

DEF X,Y 
* 
* THIS 256-TAP ADAPTIVE FIR FILTER USES ON-CHIP MEMORY BLOCK 
* BO FOR COEFFICIENTS AND BLOCK Bl FOR DATA SAMPLES. THE 
* NEWEST INPUT SHOULD BE IN MEMORY LOCATION X WHEN CALLED. 
* THE OUTPUT WILL BE IN MEMORY LOCATION Y WHEN RETURNED. 
* ASSUME THAT THE DATA PAGE IS O WHEN THE ROUTINE IS CALLED. 
* 
COEFFP EQU  »>FFOO ; BO PROGRAM MEMORY ADDRESS 
COEFFD EQU  >0200 ; BO DATA MEMORY ADDRESS 
* 
ONE EQU 7A ; CONSTANT ONE (DP=0) 
BETA EQU >7B ; ADAPTATION CONSTANT (DP=0) 
ERR EQU >7C ; SIGNAL ERROR (DP=0) 
ERRF EQU >7D ; ERROR FUNCTION (DP=0) 
Y EQU >O7E ; FILTER OUTPUT (DP=0) 
X EQU >7F ; NEWEST DATA SAMPLE (DP=0) 
FRSTAP EQU >0300 ; NEXT NEWEST DATA SAMPLE 

>O3FF ; OLDEST DATA SAMPLE 


LASTAP EQU 
* 


* FINITE IMPULSE RESPONSE 


* 


ADPFIR CNFP 
MPYK 0O 

LAC ONE,14 
LARP AR3 

LRLK AR3,LASTAP 
RPTK 255 

MACD COEFFP, *- 
CNFD 
APAC 
SACH 
NEG 
ADD 
SACH 


FIR 


Yo 


X,15 
ERR,1 


+ 


LT ERR 
MPY BETA 
PAC 
ADD ONE,14 
SACH ERRF,1 
* 
MAR *+ 
“ac x 
SACL * 
* 
LRLK AR2,COEFFD 
LRLK AR3,LASTAP 
LT ERRF 
MPY *-,AR2_ 


e 
a 


(FIR) 


FILTER. 

CONFIGURE BO AS PROGRAM: 
Clear the P register. 

Load output rounding bit. 
Point to the oldest sample. 


256-tap FIR filter. 
CONFIGURE BO AS DATA: 


Store the filter output. 


Add the newest input. 
err(i) = x(i) - y(i) 


LMS ADAPTATION OF FILTER COEFFICIENTS. 


errf(i) = beta * err(i) 
ROUND THE RESULT. 


INCLUDE NEWEST SAMPLE. 


POINT TO THE COEFFICIENTS. 
POINT TO THE DATA SAMPLES. 


P = 2*bpeta*err(1)*x(1-255) 
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ADAPT ZALR *,AR3 - LOAD ACCH WITH b255(i) & ROUND. 
MPYA *-,AR2 © b255(it1) = b255(i) + P 

P = 2*beta*err(i)*x(i-254) 

STORE b255(it1). 


me "=e 06N60lUS 


SACH *+,0,AR1 


ZALR *,AR3 
MPYA *-,AR2 


LOAD ACCH WITH b254(i) & ROUND. 
b254(it+t1) = b254(i) + P 
P = 2*beta*err(i)*x(i-253) 


SACH *+,0,AR1 STORE b254(it1). 


"™e ™%se “®e “Oe 


LOAD ACCH WITH b253(i) & ROUND. 
b253(it1) = b253(1) + P 

P = 2*beta*err(i)*x(i-252) 
STORE b253(itl1). 


ZALR *,AR3 
MPYA *-,AR2 


me “6 “™O8 66 


SACH *+,0,AR1 


ZALR *,AR3 
MPYA *-,AR2 


LOAD ACCH WITH b1(i) & ROUND. 
bi(itl) = b1l(i) + P 

P = 2*beta*err(i)*x(i-0O) 
STORE bl(itl1). 


me “=e Se SO 


SACH *+,0,AR1 


ZALR *,AR3 ; LOAD ACCH WITH bO(i) & ROUND. 
APAC *-,AR2 > bO(it1) = bO(i) + P 
SACH *+,0,AR1 - STORE bO(it1). 
* 
RET ; RETURN TO CALLING ROUTINE. 


5.7.3 Fast Fourier Transforms (FFT) 
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Fourier transforms are an important tool often used in digital signal processing 
systems. The purpose of the transform is to convert information from the time domain 
to the frequency domain. The inverse Fourier transform converts information back 
to the time domain from the frequency domain. Implementations of Fourier transforms 
that are computationally efficient are known as Fast Fourier Transforms (FFTs). The 
theory and implementation of FFTs on the TMS32020 has been discussed in an 
application report in the book, Digital Signal Processing Applications with the 


‘ TMS320 Family. The TMS320C25 reduces the execution time of all FFTs by virtue 


of its 100-ns instruction cycle time. 


In addition to the shorter cycle time, an addressing feature has been added to the 
TMS320C25 which provides execution speed and program memory enhancements 
for radix-2 FFTs. As demonstrated in Figure 5-5 and Figure 5-6 the inputs or outputs 
of an FFT are not in sequential order, i.e., they are scrambled. The scrambling of the 
data addressing is a direct result of the radix-2 FFT derivation. Observation of the 
figures and the relationship of the input and output addressing in each case reveal 
that the address indexing is a bit-reversed order, as shown in Table 5-1. As a result, 
either the data input sequence or the data output sequence must be scrambled in 
association with the execution of the FFT. 
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STAGE 1 STAGE 2 STAGE 3 
x(O) X(O) 
wo Ms 
x(4) Kina. X(1) 
i 
x(2) rn D X(2) 
wo e 
x(6) @: X(3) 
i 
x(1) CK X(4) 
t ) 
a > 
x(5) mS et) : aie 
x(3) a : X(6) 
t 
x(7) che X(7) 


LEGEND FOR TWIDDLE FACTOR: WO =Ws W1 =We W2 =Ws W3=Ws 


Figure 5-5. An In-Place DIT FFT with In-Order Outputs and Bit-Reversed 


Inputs 
STAGE 1 STAGE 2 STAGE 3 
x(0) } x(0) 
e@ 
x(1) | ° X(4) 
x(2) e 0 X(2) 
c> 
x(3) Cx> x(6) 
aa 1.98 X(1) 
<> 2 
aioe " . X(5) 
x(6) wo ry X(3) 
e 
ia X(7) 


1 w2=w? w3=w?2 


LEGEND FOR TWIDDLE FACTOR: WO =Ws W1 =We 8 8 


Figure 5-6. An In-Place DIT FFT with In-Order Inputs but Bit-Reversed 
Outputs 
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Table 5-1. Bit-Reversal Algorithm for an 8-Point Radix-2 DIT FFT 


| INDEX | BIT PATTERN 























000 
100 
010 
110 
001 
101 
011 


BIT-REVERSED PATTERN | BIT-REVERSED INDEX 
| 0 


“NOoh WN — 0 


On the TMS32020 the bit reversal was handled by loading the accumulator with pairs 
of points that needed to be swapped and then storing them back in the swapped 
locations. A new addressing feature that uses reverse carry-bit propagation allows 
the TMS320C25 to scramble the inputs or outputs while it is performing the I/O. 
The addressing mode is part of the indirect addressing implemented with the auxiliary 
registers and the associated arithmetic unit. In this mode (a derivative of indexed 
addressing), a value (index) contained in ARO is either added or subtracted from the 
auxiliary register being pointed to by the ARP. However, instead of propagating the 
carry bit in the forward direction, it is propagated in the reverse direction. The result 
is a scrambling in the address access. 


The procedure for generating the bit-reversal address sequence is to load ARO with 


a value corresponding to the length of the FFT and to load another auxiliary register, 
e.g., AR1, with the base address of the data array. Implementations of FFTs involve 
complex arithmetic; as a result, there are two data memory locations (one real and 
one imaginary) associated with every data sample. Generally, the samples are stored 
in memory in pairs with the real part in the even address locations and the imaginary 
part in the odd address location. This means that the offset from the base address 
for any given sample is twice the sample index. Real input data is easily transferred 
into the data memory and stored in the scrambled order, with every other location 
in the data memory representing the imaginary part of the data. 
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The following list shows the contents of auxiliary register AR1 when ARO is initialized 
with a value of 8 (8-point FFT) and when data is being transferred by the code that 
follows. 


MSB LSB 
ARO: 0000 0000 0000 1000. 8-Point FFT 


AR1: 0000 0010 0000 0000 Base Address 


RPTK 7 
IN *BRO+,PAO 


AR1: 0000 0010 0000 0000 -~— XR(O) 


AR1: 0000 0010 0000 1000 = XR(4) 
AR1: 0000 0010 0000 0100 — XR(2) 
AR1: 0000 0010 0000 1100 -— XR(6) 
AR1: 0000 0010 0000 0010 -— XR(1) 
AR1: 0000 0010 0000 1010 — XR(5) 
AR1: 0000 0010 0000 0110 XR(3) 
AR1: 0000 0010 0000 1110 = XR(7) 


Example 5-34 consists of lists of macros used in the implementation of FFTs. The 
first macro implements the bit reversal in the way necessary for the TMS32020 and 
is not necessary for implementations on the TMS320C25. 
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premiere 5-34. FFT Macros 
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BITREV SMACRO PR,PI,QOR,QI 


* BIT REVERSAL CODE - SWAP PR AND QR, SWAP PI AND QI. 


* 


* 
COMBO 


* 


ZALH 
ADDS 
SACL 
SACH 
ZALH 
ADDS 
SACL 
SACH 
SEND 


:PR: 
:OR: 
PR: 
:OR: 
a 
sO 1s 
;Pi? 
201s 


SMACRO R1,11,R2,12,R3,13,R4,14 


* CALCULATE PARTIAL TERMS FOR R3, R4, 13, AND I4. 


* 


* 


LAC 
ADD 
SACH 
SUB 
SACH 
LAC 
ADD 
SACH 
OUB 
SACH 


* CALCULATE 
* 


* 


LAC 
ADD > 
SACH 
SUB 
ADD 
SACH 
SUBH 
DMOV 
SACH 
LAC 
ADD 
SACH 
SUB 
SUB 
SACH 
ADDH 
SACH 


* CALCULATE 


k 


LAC 
ADD 
SACH 
SUBH 
SACH 
LAC 
ADD 
SACH 
SUBH 
SACH 
SEND 


:R3: 
:R4: 
:R3: 
:R4: 
:R4: 
el 3: 
2:14: 
:13: 
714: 
7:14: 


PARTIAL TERMS FOR 


ieee 
:R2: 
<R1: 
:R2: 
:14: 
:R2: 
:14: 
:R4: 
:R4: 
sli: 
“12% 
sIl: 
:I2: 
2:14: 
sI2: 
:14: 
214: 


PARTIAL TERMS FOR 


,i4 
,i4 
pl 
peo 
gn 
,i4 
, 14 
pod 
7-5 
a 


, 14 
, 14 
poe 
pS 
plo 


715 


eS 


,L5 


ACC 
ACC 
R3 
ACC 
R4 
ACC 
ACC 
I3 
ACC 
I4 


ACC 
ACC 
R1 
ACC 
ACC 
R2 
ACC 
r4 
R4 
ACC 
ACC 
Il 
ACC 
ACC 
T2 
ACC 
T4 


ACC 
ACC 
R1 
ACC 
R3 
ACC 
ACC 
it 
ACC 
I3 


Huu wt uw ww wou 


m0 


Hou Wd wd bow Wow wd de wd ow a we th Wea 


wa 


toi bu ud i uw ow wea 


(1/74 


(1/4) (R3) 

(1/4) (R3+R4) 

(1/2) (R3+R4) 

oe 3+xR4)-(1/2) (R4) 
ae R3-R4) 

(1/4) (13) 


(1/4) (13+14) 
(1/2) (13+14) 
(1/4) (TSF aa C72). C14) 
(1/2) (13-14) 


2, R4, I2, AND 14. 


(1/4) (R1). 
(1/4) (R1+R2) 
(1/2) (R1+R2) 

aT ere a eae 
ao R1~R2)+(1I3-14) ] 
(1/4) [ (R1-R2)+(1I3-14) ] 
(1/4) [( (R1-R2)- (13-14) ] 

R4 = (1/2) (R3-R4) 

(17a (R1- “R2) (13> T4)] 

i) 

(1/4) (11+I2) 

(I/ 2) (Iii?) 

(1/4) (I1+1I2)-(1/2) (12) 

ee 14) ] 

(1/4) [(I1-12)-(13-14) ] 

(1/4) [(I11-12)+(13-14) ] 

) + ] 


(1/4) [(I11-1I12)+(13-14) 


Ty RS Lily AND 13: 


a 

(1/4) [ (R1+R2)+(R3+R4) ] 
(1/4) [(R1+R2)+(R3+R4) ] 
ee 
(1/4) [ (R1+R2)-(R3+R4) ] 
ree 

(1/4) [(I1+1I2)+(13+14) ] 
oe 
(1/4) [(11+1I2)-(13+14) ] 
(1/4) [(I1+1I2)-(13+14) ] 
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* 
ZERO 
* 


SMACRO PR,PI,OR,QI 


* CALCULATE Re[P+Q] AND Re[P-Q] 
* 


LAC 

ADD 

SACH 

SUBH 

SACH 
* 


* CALCULATE 
* 


LAC 
ADD 
SACH 
SUBH 
SACH 
SEND 


PIBY4 
* 


LT 
LAC 
SUB 
SACH 
ADD 
SACH 
LAC 
MPY 
APAC 
SACH 
SPAC 
SPAC 
SACH 
LAC 
MPY 
APAC 
SACH 
SPAC 
SPAC 
SACH 
SEND 
* 


PIBY2 
* 


sPR:,15 ACC := (1/2) (PR) 

:OR:,15 ACC := (1/2) (PR+QR) 

PR: PR = (1/2) (PR+OR) 

:QOR: ACC := (1/2) (PR+QR)-(QR) 
:OR: OR = (1/2) (PR-QR) 

Im[P+Q] AND Im[P-Q] 

:PI:,15 ACC := (1/2) (PI) 

:Q1:,15 ACC := (1/2) (PI+QI) 

:PI: PI = (1/2) (PI+QI1) 

:Q1I: ACC := (1/2) (PI+QI)-(QI1) 
QL: QI = (1/2) (PI-QI) 


SMACRO PR,PI,OR,QI,W 


:W: T REGISTER := W=COS(PI/4)=SIN(PI/4) 
:Q01:,14 ACC := (1/4) (QI) 
:OR:,14 ACC := (1/4) (QI-QR) 
:OI:,1 OI = (1/2) (QI-QR) 
2QOR:,15 ACC := (1/4) (QI+OR) 
7OR:.,1 OR = (1/2) (QI+QR) 
:PR:,14 ACC := (1/4) (PR) 
OR: P REGISTER := (1/4) (QI+QR) *W 
ACC := (1/4) [PR+(QI+QR) *W] 
:PR:,1 PR = (1/2) [PR+(QI+QOR) *W] 
ACC := (1/4) (PR) 
ACC := (1/4) [PR-(QI+QR) *w] 
:OR:,1 OR = (1/2) [PR-(QI+OR) *W] 
:PI:,14 ACC := (1/4) (PTI) 
:QI: P REGISTER := (1/4) (QI-QR) *W 
ACC := (1/4) [PI+(QI-QR) *W] 
:PI:,1 PI = (1/2) [PI+(QI-OR) *W] 
ACC := (1/4) (PI) 
ACC := (1/4) [PI-(QI-QR) *W] 
:OI:,1 OI = (1/2) [PI-(QI-QR) *W] 


SMACRO PR,PI,QR,QI 


* CALCULATE Re[P+jQ] AND Re[P-jQ] 
* 


LAC 

SUB 

SACH 

ADDH 

SACH 
* 


* CALCULATE 
* 


LAC 

ADD 

SACH 
SUBH 
DMOV 
SACH 
SEND 


:PI:,15 ACC := (1/2) (PI) 

:OR:,15 ACC := (1/2) (PI-QR) 

PI: PI = (1/2) (PI-QR) 

:QR: ACC := (1/2) (PI-QR)+(QR) 

:QOR: OR = (1/2) (PI+QR) 
Im[P+jQ] AND Im[P-jQ] 

PR:,15 ACC := (1/2) (PR) 

:OI1:,15 ACC := (1/2) (PR+QI) 

:PR: PR = (1/2) (PR+QI) 

:Q1: ACC := (1/2) (PR+QI)-(QI) 

2OR: OR -> QI 

:OR: OR = (1/2) (PR-QI) 
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* 
-PI3BY4 SMACRO PR,PI,OR,QI,W 
* 


LT :W: 7 REGISTER := W=COS(PI/4)=SIN(PI/4) 
LAC :01:,14 ACC := (1/4) (QI) | | 
SUB :QOR:,14 ACC: := (1/4) (QI-QR) 
SACH :QI:,1 OI = (1/2) (QI-QR) 
ADD :OR:,15 ACC := (1/4) (QI+OR) 
SACH :OR:,1 QR = (1/2) (QI+QR) 

 {5AG :PR:,14 ACC := (1/4) (PR) 
MPY :OL: P REGISTER := (1/4) (QI-QR) *W 
APAC ACC := (1/4) [PR+(QI-QR) *W] 
SACH :PR:,1 PR = (1/2) [PR+(QI-QR) *W] 
SPAC ACC := (1/4) (PR) 
SPAC ACC := (1/4) [PR-(QI-QR) *W] 
MPY :OR: P REGISTER := (1/4) (QI+QR) *W 
SACH :OR:,1 OR = (1/2) [PR-(QI-QR) *W] 
LAC ' ¢PT:,14 ACC = (1/4) (PI) 
SPAC ACC := (1/4) [PI-(QI+OR) *W] 
SACH :PI:,1 PI = (1/2) [PI-(QI+OR) *W] 
APAC | ACC := (1/4) (PT) 
APAC ACC := (1/4) [PI+(QI+QR) *W] 
SACH :OI:,1 OI = (1/2) [PI+(QI+QR) *W] 
SEND 3 | 


Example 5-35 shows the bit-reversal addressing capability of the TMS320C25 for 
implementing an 8-point DIT FFT. On the TMS320C25 the following instructions 


input the data and store it in memory in the bit-reversed sequence: 


RPTK 7 
IN *BRO+,PAO 


This code combines the functions of input and bit-reversal addressing which were 
previously implemented separately on the TMS32020. The following implementation 


uses a separate bit-reverse macro: 


RPTK 7 
IN *0+,PAO 


BITREV X1R,S11I,X4R,X4I 
BITREV X3R,S31,X6R,X6I 
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Example 5-35. An 8-Point DIT FFT 


XOR EQU 00 
XOI EQU O01 
X1R EQU 02 
X1I EQU 03 
X2R EQU 04 
X21 EQU O05 
X3R EQU 06 
X31 EQU 07 
X4R EQU 08 
X41 EQU 09 
X5R EQU 10 
X51 EQU i 
X6R EQU 12 
X61 EQU 13 
X7R EQU 14 
X71 EQU 15 
W EQU 16 
WVALUE EQU >5A82 ; VALUE FOR SIN(45) OR COS(45) 
* 


* INITIALIZE FFT PROCESSING. 
* 


FFT SPM 0 ; NO SHIFT OF PR OUTPUT 
SSXM ; SET SIGN-EXTENSION MODE. 
ROVM ; RESET OVERFLOW MODE. 
LDPK 4 ; SET DATA PAGE POINTER TO 4. 
LALK  WVALUE ; GET TWIDDLE FACTOR VALUE. 
SACL W ; STORE SIN(45) OR COS(45). 

* 

* INPUT SAMPLES, STORING IN BIT-REVERSED ORDER. 

* 


LARK ARO,8 ; LOAD LENGTH OF FFT IN ARO. 
LRLK AR1,>200 ; LOAD AR1 WITH DATA PAGE 4 ADDRESS. 
LARP ARI 
RPTK 7 
IN *BRO+,PAO ; ONLY REAL-VALUED INPUT 
* 
* FIRST & SECOND STAGES COMBINED WITH DIVIDE-BY-4 INTERSTAGE 
SCALING 
* 


COMBO XOR,XOI,X1R,X11,X2R,X21,X3R,X3I, 
COMBO xX4R,X4I,X5R,X51I,X6R,X61,X7R,X71I. 


+ 


* THIRD STAGE WITH DIVIDE-BY-2 INTERSTAGE SCALING 
* 


ZERO XOR,XOI,X4R,X41 
PIBY4 X1R,X11,X5R,X5I,W 
PIBY2 X2R,X21,X6R,X6I 
PI3BY4 X3R,X31,X7R,X71,W 


+ 


* OUTPUT SAMPLES, SUPPLYING IN SEQUENTIAL ORDER. 
* 


LRLK AR1,>200 ; LOAD AR1 WITH DATA PAGE 4 ADDRESS. 
RPTK 15 

OUT *+,PAO ; COMPLEX-VALUED OUTPUT 

RET 


5-53 


Software Applications | 


Table 5-2 provides a comparison of execution speed, program memory, and data 
memory for an 8-point DIT FFT implementation using the TMS32020 and 


TMS320C25. | 


Table 5-2. FFT Memory Space and Time Requirements 


DEVICE | WORDS IN MEMORY CPU CYCLES TIME 
Data Program (us) 
TMS32020 17 169 216 43.2 
TMS320C25 17 153 178 17.8 
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6. Hardware Applications 


Information and examples on how to interface the TMS320C25 to external devices 
are presented in this section. The examples given are general enough in nature that 
they may be easily adapted to fit a particular system requirement. 


The following buses, ports, and control signals provide system interface to the 
TMS320C25 processor: 


16-bit address bus (A15-A0) 

16-bit data bus (D15-D0) 

Serial port 

PS, DS, IS (program, data, |/O space select) 
R/W (read/write) and STRB (strobe) 

READY and MSC (microstate complete) 

HOLD and HOLDA (hold acknowledge) 
INT(2-0) and IACK (interrupt acknowledge) 
XF (external flag) and BIO (branch control) 
SYNC (synchronization) and BR (bus request) 

















Major hardware applications discussed in this section are listed below. 


External Local Memory Interface (Section 6.1 on page 6-2) 
Wait States (Section 6.2 on page 6-3) 

Direct Memory Access (Section 6.3 on page 6-4) 

Global Memory (Section 6.4 on page 6-6) 

Codec Interface (Section 6.5 on page 6-7) 

|/O Ports (Section 6.6 on page 6-8) 
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6.1 External Local Memory Interface 
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The external local memory interface provides the versatility to interface the 
TMS320C25 to a wide variety of memory devices. For example, if speed and maxi- 
mum throughput are desired, the TMS320C25 can run with zero wait states and 
perform memory accesses in a single machine cycle. The TMS320C25 can access 
slower memories by inserting one or more wait states into the memory access oper- 
ation by using the READY input signal. 


If the internal data RAM on the TMS320C25 is sufficient for system needs, a minimal 
memory configuration, such as the one shown in Figure 6-1, can be implemented. 
In the example, two (2K x 8) PROMs are used as program memory. No address 
decoding is performed, and the PS control signal is used as the chip enable. 


Depending on the access time of the PROMs, the READY input can be either 
connected to a logic high for zero wait states or connected to the MicroState 
Complete (MSC) pin for automatic one wait-state generation. 


TBP38L165 


A10-AO 


TMS320C25 





T4ALS32 


Figure 6-1. Minimal External Program Memory Configuration 
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6.2 Wait States 


The number of cycles in a memory or I/O access is determined by the state of the 
READY input. At the start of quarter-phase 3, the TMS320C25 samples the READY 
input. If READY is high, the memory access ends at the next falling edge of 
CLKOUT1. If READY is low, the memory cycle is extended by one machine cycle, 
and all other signals remain valid. At the beginning of the next quarter-phase 3, this 
sequence Is repeated. Figure 6-2 shows a one wait-state memory access. Note that 
for on-chip program and data memory accesses, the READY input is ignored. 


Phse# 4/ 1, 2/1 3, 4 | 1,2 «|3 , 4 [1 







CLKOUT1 


READY 


D15-D0O 
(FOR READ 
OPERATION) 


D15-DO 
(FOR WRITE 
OPERATION) 
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(YXXXXKA : 

YA 

YD 
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MSC 





Figure 6-2. One Wait-State Memory Access Timing 


The automatic generation of one wait state can be accomplished by the use of the 
MicroState Complete (MSC) signal. The MSC output is asserted low during 
CLKOUT?1 low to indicate the beginning of an internal or external memory or |/O 
operation (see Figure 6-2). By gating MSC with the address and PS, DS, and/or 
IS, a one-wait READY signal can be generated (see Figure 6-3). 


6-3 


Hardware Applications 


MSC 
| Pe 
TMS320C25 
“SIGNALS DS 

is 


A15-A0 





Figure 6-3. One Wait-State Generator Using MSC 


6.3 Direct Memory Access 
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The TMS320C25 supports Direct Memory Access (DMA) to its external 
program/data memory using the HOLD and HOLDA signals. Direct memory access 
can be used for multiprocessing by temporarily halting the execution of one or more 
processors to allow another processor to read from or write to the halted processor's 
local off-chip memory. Here the multiprocessing is typically a master-slave config- 
uration. The master may initialize a slave by downloading a program into its program 
memory space and/or provide the slave with the necessary data to complete a task. 








In a typical TMS320C25 direct memory access scheme, the master may be a gener- 
al-purpose CPU, another TMS320C25, or perhaps even an analog-to-digital 
converter. A simple TMS320C25 master-slave configuration is shown in Figure 6-4. 
The master TMS320C25 takes complete control of the slave’s external memory by 
asserting HOLD low via its external flag (XF). This causes the slave to place its 
address, data, and control lines in a high-impedance state. By asserting RS in 
conjunction with HOLD, the master processor can load the slave’s local program 
memory with the necessary initialization code on reset or powerup. The two 











_ processors can be synchronized using the SYNC pin to make the transfer over the 


memory bus faster and more efficient. 


After control of the slave’s buses is given up to the master processor, the slave alerts 
the master of this fact by asserting HOLDA. This signal may be tied to the master 
TMS320C25’s BIO pin. The slave’s XF pin may be used to indicate to the master 
when it has finished performing its task and needs to be reprogrammed or requires 
additional data to continue processing. In a multiple slave configuration, the priority 
of each slave’s task may be determined by tying the slave’s XF signals to the 
appropriate INT(2-0) pin on the master TMS320C25. 
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Figure 6-4. Direct Memory Access Using a Master-Slave Configuration 


A PC environment presents another example of a potential direct memory access 
scheme where a system bus (the PC-bus) is used for data transfer. In this config- 
uration, either the master CPU or a disk controller may place data onto the system 
bus, which can be downloaded into the local memory of the TMS320C25. Here the 
TMS320C25 acts more like a peripheral processor with multifunction capability. In 
a speech application, for example, the master can load the TMS320C25’s program 
memory with algorithms to perform such tasks as speech analysis, synthesis, or 
recognition, and fill the TMS320C25’s data memory with the required speech 
templates. In another application example, the TMS320C25 can serve as a dedicated 
graphics engine. Programs can be stored in TMS320C25 program ROM or down- 
loaded via the system bus into program RAM. Data can come from PC disk storage 
or provided directly by the master CPU. 


Figure 6-5 depicts a direct memory access using a PC environment. In this config- 
uration, decode and arbitration logic is used to control the direct memory access. 
When the address on the system bus resides in the local memory of the peripheral 
TMS320C25, this logic asserts the HOLD signal of the TMS320C25 while sending 
the master a not-ready indication to allow wait states. After the TMS320C25 
acknowledges the direct memory access by asserting HOLDA, READY is asserted and 
the information transferred. 
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Figure 6-5. Direct Memory Access in a PC Environment 


6.4 Global Memory 
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In various digital signal processing tasks, such as filters or modems, the algorithm 
being implemented may be divided into sections with a distinct processor dedicated 
to each section. In this multiple processor scheme, the first and second processors 
may share global data memory, as well as the second and third, the third and fourth, 
etc. Arbitration logic may be required to determine which section of the algorithm 
is executing and which processor has access to the global memory. With multiple 
processors dedicated to distinct sections of the algorithm, throughput may be 
increased via pipelined execution. | 


The external memory of the TMS320C25 can be divided into both global and local 
sections. Special registers and pins included on the TMS320C25 allow multiple 
processors to share up to 32K words of global data memory. This implementation 
facilitates efficient “shared data” multiprocessing where data is transferred between 
two or more processors. Unlike a direct memory access scheme, reading or writing 
global memory does not require one of the processors to be halted. 


The size of the global memory is programmable between 256 and 32K locations in 
data memory by loading the global register (GREG). After global memory is defined 
in the GREG, the TMS320C25 asserts the BR (bus request) signal before each global 
memory access. The processor then inserts wait states until a bus grant is given by 
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asserting the READY line. Figure 6-6 illustrates such a global memory interface. 
Since the processors can be synchronized by using the SYNC pin, the arbitration logic 
may be simplified and the address and data bus transfers more efficient. 


The SYNC pin on the TMS320C25 may also be used to synchronize several proces- 
sors to allow for execution of redundant fail-safe systems. SYNC permits instruction 
broadcasting between several processors and lock-step execution after initial 
synchronization. 





TMS320C25 TMS320C25 















BR BR 


READY 





LOGIC 


SYNC 
GENERATION CLOCK 
| LOGIC 
PROGRAM PROGRAM 
MEMORY MEMORY 


Figure 6-6. Global Memory Communication 


6.5 Codec Interface 


In some areas of telecommunications, speech processing, and other applications that 
require low-cost analog |/O devices, a codec may be useful. The combo-codec used 
here consists of nonlinear A/D and D/A converters with all the associated filters and 
data-holding registers. 


The TMS320C25 serial port allows communication with serial devices such as 
codecs. The speed and versatility of the TMS320C25 allow it to compand (COMpress 
and exPAND) a PCM (Pulse Code Modulation) data stream, acquired by the codec, 
through the TMS320C25 execution of software conversion routines (see the appli- 
cation report, “Companding Routines for the TMS32010/TMS32020,” in the book, 
Digital Signal Processing Applications with the TMS320 Family). Figure 6-7 shows 
an interface example of a Texas Instruments TCM2913 codec to the TMS320C25 
serial port. 


6-7 


Hardware Applications 
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FREQUENCY 
DIVIDER OSCILLATOR 
Figure 6-7. Codec Interface 


In this configuration, all timing and synchronization signals are externally generated 
using independent oscillator and frequency-dividing hardware such as the 74AS867 
or 74LS161 counters. Alternatively, the designer may decide to generate the timing 
signals from the TMS320C25 clock by subdividing its frequency. 


In some circuits, it may be necessary to include an opamp at the analog output of 
the codec. In such cases or if variable output gain is required, a gain-setting resistor 
network must be provided as specified in the TCM2913 documentation. 


Other linear A/D and D/A converters may be interfaced to the TMS320C25 through 
its parallel ports as well as the serial ports. 


6.6 I/O Ports 
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|/O design on the TMS320C25 is treated the same way as memory. The I/O address 
space is distinguished from the local program/data memory space by the IS signal. 
IS goes low at the beginning of the memory cycle. All other control signals and timing 
parameters will be the same as those for the program/data external memory interface. 


The TMS320C25 software instructions can access 16 input and 16 output ports. 
The four least significant bits of the address bus specify the particular port being 
accessed. A pair of 74AS138s can be used to fully decode these address bits (see 
Figure 6-8). 


Hardware Applications 


74AS138 





/O PORT11 
I/O PORT10 
I/O PORT 9 


/O PORT 8 
TMS320C25 
SIGNALS 


1/0 PORT 7 
0 PORT 6 
0 PORT 5 
(70 PORT 4 
1/0 PORT 3 
VO PORT 2 


Figure 6-8. 1/O Port Addressing 


A simple interface between two processors can be implemented using up to 16 
bidirectional |/O ports connected to the TMS320C25. An interprocessor communi- 
cation path can be formed by memory-mapping peripherals to the |/O ports of the 
TMS320C25. In this manner, the TMS320C25 can connect to parallel A/Ds, registers, 
FIFOs, two-port memories, or other peripheral devices. In a multiprocessing scheme, 
intelligent peripherals can be memory-mapped into the |/O ports. Here the 
TMS320C25 can communicate with UARTs, general-purpose microprocessors, disk 
controllers, video controllers, or other peripheral processors. 


Using an 8-bit general-purpose microprocessor, such as Tl’s TMS7042, for a 
keyboard interface is an example of a TMS320C25 |/O port multiprocessing scheme, 
as shown in Figure 6-9. The TMS7042 may be mapped into the TMS320C25 |/O 
space using latches to store the transferred data. In a single or multiple |/O port 
multiprocessing configuration, the four LSBs of the address bus are decoded to 
determine which of the 16 I/O ports on the TMS320C25 is being accessed. The 
TMS320C25 selects the I/O space (IS) for its external bus and reads/writes data 
using the IN/OUT instructions. 


Processor-controlled signals between the TMS320C25 and the peripheral device 
indicate when data is available to be read. This interprocessor communication is 
facilitated by using the input and output pins of the TMS7042 (or other peripheral 
processor). In an |/O multiprocessing configuration, the |/O port address space is 
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limited, and data transfers are relatively slow compared to a direct memory access 


or global memory configuration. 
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Figure 6-9. I/O Port Processor-to-Processor Communication 
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7. Assembler Directives 


The TMS320C25 Macro Assembler translates mnemonic instructions and assembler 
directives specified by the TMS320C25 assembly language source code into 
executable object code. Some directives make sections of the program relocatable, 
others define constants for data or text, and still others provide linkage between 
separate program modules to form a complete executable program. After the Link 
Editor links a program as required, the TMS320C25 Simulator provides simulation 
for effective software development and program verification. 


Given a file of TMS320C25 source code as input, the assembler outputs a listing file, 
an object file, an optional symbol table, and a cross-reference list. The assembler 
also provides a comprehensive set of error diagnostics. 


Major topics discussed in this section are listed below. 


@ Creation of TMS320C25 Source Code (Section 7.1 on page 7-2) 
Label field 
Command field 
Operand field 
Comment field 
Assembly language elements: 
- Symbols (Section 7.2 on page 7-4) 
- Constants (Section 7.3 on page 7-4) 
- Character strings (Section 7.4 on page 7-6) 
- Expressions (Section 7.5 on page 7-6) 


e Assembler Directives (Section 7.6 on page 7-9) 
Functional groupings 


@ Individual Directive Descriptions (Section 7.7 on page 7-12) 
Presented in alphabetical order and providing the following: 
- Syntax 
- Description 
- Example(s) 
@ Source Listing Format (Section 7.8 on page 7-44) 
& Object Code (Section 7.9 on page 7-45) 
Object code format 
Changing object code 
@ Cross-Reference Listing (Section 7.10 on page 7-50) 


© Assembler Error Messages (Section 7.11 on page 7-51) 
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7.1 Creation of TMS320C25 Source Code 


The TMS320C25 assembly language consists of operation codes (called mnemonics) 
that correspond directly to binary machine instructions. An assembly language 


_ program is called a source program. Before it can be executed by the computer, the 


source program must be processed by the assembler to obtain a machine language 


- program. This processing of a source program is called assembling. This consists 


of combining the binary values (which correspond to the operation code) with the 


binary address information to form the machine language instruction. 


The TMS320C25 Assembler is a two-pass assembler that processes source code 
twice. On the first pass, the assembler maintains the location counter (which defines 
the program memory addresses assigned to the resulting words of object code), 
builds a symbol table, and produces a list file of the source code. On the second 
pass, the assembler produces the object code using the operation codes and the 
symbol table of the first pass. 


An assembly language source program consists. of source statements that may 
contain assembler directives, machine instructions, or comments. Source statements 
scanned by the assembler may contain four ordered fields (label, command, operand, 
and comment) separated by one or more blanks. Source statements containing an 
asterisk (“) in the first character position are comment statements, and as such, have 
no effect on the assembly. The source statement line may be as long as the source 
file format allows; however, the assembler truncates the source line to 60 characters 
without warning. Only comments may extend past column 60 without an error 
resulting. 


The TMS320C25 Assembler uses the ASCII character set. 


The syntax for source statements is as follows: 


[<label>] <mnemonic> [<operand>] [<comment>] 


A source statement may have a label that is user-defined. The label field begins in 
character position one of the source statement. At least one blank must separate the 
label from the command mnemonic, the mnemonic from the operand (when an 
operand is required), and the operand(s) from the comment field. 


The last source statement of a source program, usually the END directive, is followed 
by the end-of-file statement for the source medium. 


7.1.1 Label Field 
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The label field begins in character position one of the source statement and contains 
a label of up to six significant characters. The first character of the label must be 
alphabetic; additional characters may be alphanumeric. A label is optional for machine 
instructions and for many assembler directives. When the label is omitted, the first 
character position must contain a blank. 


A source statement consisting of only a label field is a valid statement. It has the 
effect of assigning the current value of the location counter to the label as well as 
to the next source statement. This is equivalent to the following directive statement: 


<label> EQU §$ Where §$ represents the current value of the location 
counter at that point in the assembly. 
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7.1.2 Command Field 


The command field begins after the blank that terminates the label field, or in the first 
non-blank character past the first character position (which must be blank when the 
label is omitted). The command field is terminated by one or more blanks and may 
not extend past the right margin. The command field may contain one of the 
following: 


@ Assembler mnemonic of a machine instruction (e.g., MAC) 
@ Macro mnemonic (e.g., FACT) 
@ Assembler directive (e.g., DATA) 


7.1.3: Operand Field 


The operand field begins following the blank that terminates the command field and 
may not extend past the right margin of the source statement. The operand field is 
terminated by one or more blanks. | 


The operand field may contain one or more of the following: 


& Constants 
@ Character strings 
@ Expressions 


Symbols used in the operand field must be defined in the assembly, usually by 
appearing in the label field of a statement or in the operand field of a REF (external 
reference) or SREF (secondary external reference) directive. REF and SREF directives 
provide access to symbols defined in other programs. 


7.1.4 Comment Field 


The comment field begins after the blank terminating the operand field or the blank 
terminating the command field, as in the case of commands that have no operands. 
The comment field may extend to the end of the source statement (if required) and 
may contain any ASCII character including blank(s). The contents of the comment 
field up to the end of the source record are listed in the source portion of the assembly 
listing and have no other effect on the assembly. 
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7.2 Symbols 


Symbols are used in the label field and the operand field. A symbol is a string of 
alphanumeric characters, (‘A’ through ‘Z’, ‘0’ through ‘9’, and ’$’). The first character 
in a symbol must be ‘A’ through ‘Z’ or ‘$’. No character may be blank. When more 
than six characters are used in a symbol, the assembler prints all the characters, but 
accepts only the first six characters for processing (the assembler prints a warning 
indicating that the symbol has been truncated). Therefore, symbols must be unique 
in the first six characters. User-defined symbols are valid only during the assembly 
in which they are defined. 


Symbols used in the label field become symbolic addresses. They are associated 
with locations in the program and must not be used in the label field of other state- 
ments. Mnemonic operation codes and assembler directive names may also be used 
as valid user-defined symbols when placed in the label field. 


Any symbol appearing in the label field of a source statement, other than an EQU 


- (define assembly-time constant) directive, is either absolute or relocatable depending 


on whether or not the statement is in an absolute (specified) block of the program. 


7.2.1 Predefined Symbols 


The predefined symbols are the dollar sign character ($) and the auxiliary register 
and port symbols. The dollar sign character is used to represent the current location 
within the program. The auxiliary register symbols are of the form ‘ARn’ where ‘n’ 
is 0 to 4. The port addresses are of the form ‘PAn’ where ‘n’ is 0 through 15. 


Examples of valid predefined symbols: 


$ Represents the current location 
ARO Represents Auxiliary Register 0 
PA12 Represents Port Address 12 


7.3 Constants 
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The assembler recognizes the following five types of constants, each internally 
maintained as a 16-bit quantity: 


Decimal integer constants 
Binary integer constants 
Hexadecimal integer constants 
Character constants 
Assembly-time constants 


Decimal, binary, hexadecimal, and character constants are absolute. Assembly-time 
constants defined by absolute expressions are absolute, and assembly-time constants 
defined by relocatable expressions are relocatable. 


Assembler Directives 


7.3.1 Decimal Integer Constants 


A decimal integer constant is written as a string of decimal digits. Decimal integers 
range in value from -32,768 to +32,767. Positive decimal integer constants in the 
range of 32,768 to 65,535 are considered negative when interpreted as two’s- 
complement values. 


Examples of valid decimal constants: 


1000 Constant equal to 1000 or >3E8 
-32768 Constant equal to -32768 or >8000 
25 Constant equal to 25 or >19 


7.3.2 Binary Integer Constants 


A binary integer constant is written as a string of up to 16 binary digits (O or 1) 
preceded by a question mark, ‘?’. If less than 16 digits are specified, the assembler 
right-justifies the given bits in the resulting constant. 


Examples of valid binary constants: 


20000000000010011 Constant equal to 19 or >0013 
20111111111111111 Constant equal to 32767 or >7FFF 
211110 Constant equal to 30 or >O0O1E 


7.3.3 Hexadecimal Integer Constants 


A hexadecimal integer constant is written as a string of up to four hexadecimal digits 
preceded by a ‘greater than’ sign, ‘>’. If less than four hexadecimal digits are spec- 
ified, the assembler right-justifies the given bits in the resulting constant. Hexade- 
cimal digits include the decimal values ‘0’ through ‘9’ and the letters ‘A’ through ‘F’. 


Examples of valid hexadecimal constants: 


>78 Constant equal to 120 or >0078 
>F Constant equal to 15 or >QOOF 
>37AC Constant equal to 14252 or >37AC 


7.3.4 Character Constants 


A character constant is written as a string of one or two alphabetic characters 
enclosed in single quotes. Two consecutive single quotes represent each single 
quote contained within a character constant. If less than two characters are specified, 
the assembler right-justifies the given bits in the resulting constant. The characters 
are represented internally as eight-bit ASCII characters. A character constant 
consisting only of two single quotes (no character) is valid and is assigned the value 
0000 (hexadecimal). 


Examples of valid character constants: 


‘AB’ Represented internally as >4142 
CC Represented internally as >0043 
"N’ Represented internally as >OO4E 
“D—! Represented internally as >2744 
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7.3.5 Assembly-Time Constants 


An assembly-time constant is a symbol given a value by an EQU directive. The value 
of the symbol, determined at assembly time, is considered to be absolute or relocat- 
able according to the relocatability of the expression, not according to the relocata- 
bility of the location counter value. Absolute value symbols may be assigned values 
with expressions using any of the above constant types. 


7.4 Character Strings 


Some assembler directives require character strings in the operand field. A character 
string is written as a string of characters enclosed in single quotes. Two consecutive 
single quotes represent a single quote in a character string. The maximum length 
of the string is defined for each directive requiring a character string. The characters 
are represented internally as eight-bit ASCII. 


Examples of valid character strings: 


‘SAMPLE PROGRAM’ Defines a 14-character string consisting of SAMPLE 
PROGRAM. 


"PLAN °C’”’ | Defines an 8-character string consisting of PLAN ’C’. 


7.5 Expressions 
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Expressions are used in operand fields of assembler directives and machine 
instructions. An expression is a constant or symbol, a series of constants or symbols, 
or a series of constants and symbols separated by arithmetic operators. Each constant 
or symbol may be preceded by a plus sign (unary plus), a minus sign (unary minus), 
or the # symbol (unary invert). Unary minus takes the two’s complement of the 
expression, and unary invert takes the one’s complement. The # symbol yields the 
value of the logical complement of the following constant or symbol. An expression 
does not contain embedded blanks. The valid range of values for an expression is 
-32,768 to +65,535. 


An expression is relocatable when the number of relocatable symbols or constants 
added to the expression is one greater than the number of relocatable symbols or 
constants subtracted from the expression. (All other valid expressions are absolute. ) 
When the first symbol or constant is unsigned, it is considered as added to the 
expression. For example, when all symbols in the ronowing expressions are relo- 
catable, the expressions are relocatable: 


LABEL+1 
LABEL+TABLE+-INC 
-LABEL+TABLE+INC 
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7.5.1 Arithmetic Operators in Expressions 


Arithmetic operators used in expressions are as follows: 


+ for addition 

- for subtraction 

“ for multiplication 
/ for division 


In evaluating an expression, the assembler first negates any constant or symbol 
preceded by a unary minus and then performs the arithmetic operations from left to 
right. The assembler does not assign precedence to any operation other than unary 
plus or unary minus. All operations are integer operations. The assembler truncates 
the fraction in division. When a unary minus follows a subtraction operator, the 
effective operation is addition. The unary minus cannot be applied to a relocatable 
expression or subexpression. For example, the expression 4+5*2 would be evaluated 
as 18, not 14; and the expression 7+1/2 would be evaluated as 4, not 7. 


The assembler checks for a valid range of values. The warning message ‘VALUE 
TRUNCATED’ ts given when a value is out of range. 


An example of where a ‘VALUE TRUNCATED’ message is given: 


B 65538 


7.5.2 Parentheses in Expressions 


The assembler supports the use of parentheses in expressions to alter the order of 
evaluation of the expression. Nesting of pairs of parentheses within expressions is 
also supported. Evaluation of portions of an expression within parentheses at the 
Same nesting level may be considered to be simultaneous. Parentheses cannot be 
nested more than eight levels deep. 


For example, the use of parentheses in the expression LAB1+((4+3)*7) results in 
the following operation: 


1) Add four to three, 
2) Multiply the resulting sum by seven, and 
3) Add the resulting product to the value of LAB1. 


7.5.3 Well-Defined Expressions 


Some assembler directives require well-defined expressions in operand fields. For 
an expression to be well-defined, any symbols or assembly-time constants in the 
expression must have been previously defined. The evaluation of a well-defined 
expression must be absolute, and a well-defined expression must not contain a 
character constant. An example of a well-defined expression is as follows: 


>1000+X Where X must have been previously defined. 
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7.5.4. Absolute and Relocatable Symbols in Expressions 


The value of an expression containing absolute or relocatable symbols is either 
absolute or relocatable depending on a precise set of rules. An expression containing 
a relocatable symbol or relocatable constant immediately following a multiplication 
or division operator is illegal. When the result of evaluating an expression up to a 
multiplication or division operator is relocatable, the expression is also illegal. Table 
7-1 defines the relocatability of the result for each type of operator. 


If the current value of an expression is relocatable with respect to one relocatable 
section, a symbol of another section cannot be included until the value of the 
expression becomes absolute. The following are examples of legal expressions: 


BLUE+1 The sum of the value of symbol BLUE plus one is legal and of the 
same type as BLUE. 


GREEN-4 The result of subtracting four from the value of symbol GREEN is 
legal and of the same type as GREEN. 


2*16+RED The sum of the value of symbol RED plus the product of two times 
16 is legal, and of the same type as RED. 


440/2-RED The result of dividing 440 by two and subtracting the value of 
symbol RED from the quotient (RED must be absolute for this to 
be a legal expression). 


Table 7-1. Results of Operations on Absolute and Relocatable Items 


Peeer? ieee eee ae 
AND B es = A'B 


ais [ass asco 
pag eal regret net een eee 
[—necoc [Reto | illegal | Note4 | legal | ilegal 













Notes: 1. {legal unless A equals zero or one. If A is one, the result is relocatable; if A is zero, the 
result is an absolute zero. 

illegal unless B equals zero or one. If B is one, the result is relocatable; if B is zero, the 
result is an absolute zero. 

Illegal unless B equals one. If B equals one, the result is relocatable. 

Illegal unless A and B are in the same section. If A and B are in the same section, the result 
is absolute. 


Po N 


7.5.5 Externally Referenced Symbols in Expressions 
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As defined in the REF (external reference) and SREF (secondary external reference) 
directives, the assembler allows externally referenced symbols in expressions under 
the following conditions: 


1) Only one externally referenced symbol is used in an expression. 


2) The character preceding the referenced symbol must be a blank, a plus sign, 
oracomma. The portion of the expression preceding the symbol, if any, must 
be added to the symbol. 
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3) The portion of the expression following the referenced symbol must not include 
multiplication or division on the symbol (as for a relocatable symbol). 


4) The remainder of the expression following the referenced symbol must be 
absolute. 


The link editor resolves all externally referenced symbols automatically. However, 
the assembler limits the user to a total of 255 externally referenced symbols per 
module. Modules using more than 255 external symbols must be broken into smaller 
modules for assembly, and linked using the link editor. 


7.6 Assembler Directives 


Assembler directives are instructions that control the assembly process rather than 
produce object code for machine instructions. The TMS320C25 Assembler supports 
directives in the following categories: 


Directives that affect the location counter 
Directives that affect assembler output 

Directives that initialize constants 

Directives that provide linkage between programs 
Miscellaneous directives. 


7.6.1 Directives That Affect the Location Counter 


As the assembler reads the source statements of a program, the location counter is 
set to correspond to the memory locations assigned to the resulting object code. 
The thirteen assembler directives that affect the location counter are shown in Table 
7-2. The first nine initialize the location counter and define its value as relocatable, 
absolute, or dummy. The next two directives set the location counter to provide a 
block of program memory for the object code. The last two directives define a block 
of an independently stored program segment. 


Table 7-2. Assembler Directives That Affect the Location Counter 


Absolute origin 
Relocatable origin 

Dummy origin 

Block starting with symbol 
Block ending with symbol 
Data segment 


Data segment end 

Common segment 

Common segment end 
Program segment 

Program segment end 
Independent program segment 
Independent segment end 





7-9 


Assembler Directives 


7.6.2 Directives That Affect Assembler Output 


Directives that affect assembler output (see Table 7-3) are primarily used to improve 
user interface. The first directive supplies a program identifier in the object code. 


- The other five directives in this category format the source listing. 


Table 7-3. Assembler Directives That Affect Assembler Output 


DIRECTIVES | MNEMONICS 


Program identifier 
Output options 
Page title 
Restart source listing 
Stop source listing 
Eject page 








7.6.3 Directives That Initialize Constants 


Table 7-4 lists those directives that initialize constants. DATA and TEXT assign 
hexadecimal values in successive words of the object code. EQU initializes a constant 
for use during the assembly process. 


Table 7-4. Assembler Directives That Initialize Constants 


DIRECTIVES MNEMONICS 


Initialize word DATA 
Initialize text TEXT 
Define assembly-time constant EQU 









7.6.4 Directives That Provide Linkage Between Programs 


Two pairs of directives, DEF/REF and SREF/LOAD, generate the information required 
to link program modules, thereby making it unnecessary to assemble an entire 
program in the same assembly. A long program may be divided into separately 
assembled modules to avoid a long assembly or to reduce the symbol table size. 
Modules common to several programs may also be combined as required. Program 
modules may be linked by the link editor to form a linked object module that may 
be stored on a library and/or loaded as required. 


The DEF/REF directives enable program modules to be assembled separately and 
integrated into an executable program. The DEF directive places one or more symbols 
defined in. the module into the object code of the assembled module, thus making 
them available for linking. The REF directive places symbols used in the module, 
but defined in another module, into the object code of the assembled module, 
allowing them to be linked. 


The Link Editor’s major function is to provide symbol resolution for external references 


and definitions created by the REF and DEF assembler directives (see Table 7-5). 


Each symbol defined in a program module and required by other program modules 


_ must be placed in the operand field of a DEF directive in the program module defining 


it and in the operand field of a REF directive in the program module referencing it. 
All program modules to be linked by the link editor must include an IDT directive 
with a character string enclosed in single quotes placed in its operand field as the 
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program module name. The link editor builds a list of symbols from DEF directives 
as it links the program modules, and matches symbols from REF directives to the 
symbols in the list. The link editor follows linking commands to determine the 
modules to be linked. If the module in which a routine is defined has the same name 
as the routine entry points, the link editor can automatically locate the required 
module in a designated library. 


The Link Editor requires a link control file as input to specify the task name, to define 
the starting location for the data and program segments, and to indicate the object 
files to be linked. The following linker commands are the primary commands that 
should be included in a link control file: 


FORMAT ASCII 

TASK <taskname> 

PROGRAM >0000 

DATA >0000 

INCLUDE <object code filenames separated by commas> 
INCLUDE < or listed in separate INCLUDE commands > 
END 


The Link Editor outputs two files when linking TMS320C25 object modules. The 
first file is a source listing file that shows the source statement number, a location 
counter value, the assembled object code, the source statement as entered, and a 
cross-reference listing of externally defined variables. The second file contains the 
actual load module of linked object code to be executed by the TMS320C25. 


Table 7-5. Assembler Directives That Provide Linkage Between Programs 


DIRECTIVES [MNEMONICS, 


External definition 


External reference 
Secondary external reference 
Force load 





7.6.5 Miscellaneous Directives 


This category includes assembler directives not applicable to the other categories. 


Table 7-6. Miscellaneous Assembler Directives 


| DIRECTIVES ———_—‘| MNEMONICS| 


Program end END 
Copy source file COPY 
Define MACRO library | MLIB 









The Macro Library (MLIB) assembler directive provides the TMS320C25 Assembler 
with the name of a library containing macro definitions. The operand of this directive 
is a directory pathname (constructed according to the conventions of the host 
operating system) enclosed in single quotes. The macros listed in this directory are 
user-defined, one macro per file. The MLIB directive is defined only for hosts that 
support libraries. 
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7.7 Individual Directive Descriptions 
Each TMS320C25 assembler directive is described in this section. Directives are listed 
in alphabetical order. — | | . 


The majority of the instruction symbols used to describe the syntax of the assembler 
directives is identical to those symbols in Table 4-2. Those that are introduced for 
the first time or have definitions specific to this section are listed in Table 7-7. 


Table 7-7. Assembler Directive Symbols 
SYMBOL|____—*MEANING Ss 
label The contents of the label field 
exp An expression 


wd-exp A well-defined expression 


comment | The contents of the comment field 


string A character string 

py Items within slashes can be used only if the 
operand field is not empty. When not empty, 
they are optional. 


Items within brackets. are optional. 





Items within single quotes are character 
constants or character strings. 








AORG Absolute Origin Directive __AQRG 


Syntax [<label>] AORG [<wd-exp> /<comment>/] 


When a label is used, it is assigned the value that the AORG directive places in 
the location counter. 


Description AORG places a value in the location counter and defines the succeeding locations 
as absolute. An absolute location is not affected by relocation. Upon encount- 
ering an AORG statement, the assembler places the value of the well-defined 
expression into the location counter. When no AORG is entered, no absolute 
addresses are included in the object program. When the operand field is not used, 
the length of all preceding absolute code replaces the value in the location 
counter. 


Example 1 AORG >1000+X 


>1000+X must be a well-defined expression. If X has a value of 6, the location 
counter is set to >1006. 


Example 2 HEX AORG >1000 


The location counter is set to > 1000. The label HEX is assigned the value >1000. 





Syntax 


Description 


Example 





[<label>] BES <wd-exp> [<comment>] | 


‘When used, a label is assigned the value of the location following the block. 


BES advances the location counter by the value in the operand field. The operand 
field contains a well-defined expression representing the number of words to be 


_ added to the location counter. BES assigns a label the value of the location 


following the block. 


BUFF2 BES >10 


BES reserves a 16-word buffer. If the location counter contains >100 when the 
assembler processes this directive, BUFF2 is assigned the value >110. 


BSS Block Starting with Symbol Directive BSS 


Syntax [<label>] BSS <wd-exp> [<comment>] 


When used, a label is assigned the value of the location of the first word in the 
block. 





Description BSS advances the location counter by the value of the well-defined expression 
(wd-exp) in the operand field. The well-defined expression represents the number 
of words to be added to the location counter. BSS assigns a label the value of 
the location of the first word in the block. 


Example BUFF1 BSS >10 


If the location counter contains > 100 when the assembler processes this directive, 
BUFF1 is assigned >100. The location counter is set to >110. 


CEND Common Segment End Directive _ CEND 


Syntax _ [<label>] CEND [<comment>] 
When used, a label is assigned the value of the location counter prior to modifi- 
cation. : 

Description CEND terminates the definition of a block of common-relocatable code by placing 


a value in the location counter and defining succeeding locations as program- 
relocatable. CEND results in setting the location counter to one of these values: 


@ The maximum value the location counter has ever attained as a result of the 
assembly of any preceding block of program-relocatable code, or 


@ Zero, if no program-relocatable code has been previously assembled. 


lf encountered in data- or program-relocatable code, CEND functions as a DEND 
or PEND, and a warning message is issued. Like DEND and PEND, CEND is 
invalid when used in absolute code. 


Example See CSEG for an example of the use of CEND. 





COPY Copy Source File Directive COPY 


Syntax 


Description 


Example 


[<label>] COPY <file-name> [<comment>] 


COPY causes the assembler to read source statements from a different file. The 
file name may be one of the following: 


@ An access name recognized by the operating system, or 


@ Asynonym form of an access name. 


When end-of-file is reached, the assembler resumes processing source statements 


from the file or device previous to the COPY directive. A COPY directive may be 
placed in a file being copied. Nested copying of files can be performed by placing 
a COPY directive in a file being copied. Such nesting is limited by the assembler 
to eight levels; additional restrictions may be set by the host operating system. 


COPY SFILE.ASM 


COPY causes the assembler to take source statements from a file called 
SFILE.ASM. 


CSEG Common Segment Directive ee CSEG 


Syntax 


Description 


[<label>] CSEG [’<string>’ /<comment>/] 


When used, a label is assigned the value placed by the directive in the location 
counter. . Ea | | 


CSEG defines succeeding locations as common-relocatable. CSEG permits the 
construction and definition of independently relocatable data segments that 
several programs may access or reference at execution time. The segments are 
assembly language counterparts of FORTRAN COMMON. Information placed in 
the object code by the assembler permits the link editor to relocate all common 
segments independently and make appropriate adjustments to all addresses 
referencing locations within common segments. The difference between CSEG 
and DSEG is that locations within a particular common segment may be refer- 
enced by several different programs if each program contains a CSEG directive 
with the same operand or no operand. 


lf the operand field is not used, the CSEG directive defines the beginning (or 
continuation) of the blank common segment of the program. When used, the 
operand field contains a character string of up to six characters enclosed in quotes. 
(If the string length exceeds six characters, the assembler prints a truncation error 
message and retains the first six characters of the string.) If this string has not 
previously appeared as the operand of a CSEG directive, the assembler associates 
a new relocation section number with the operand, sets the location counter to — 
zero, and defines succeeding locations as relocatable with respect to the new 
relocatable section. When the operand string has been previously used in a CSEG, 
the succeeding code represents a continuation of the particular common segment 
associated with the operand. The location counter is reset to the maximum value 
attained during the previous assembly of any portion of that particular common 
segment. 


The following directives properly terminate the definition of a block of 
common-relocatable code: CEND, PSEG, DSEG, AORG, and END. The block is 
normally terminated with a CEND directive. The PSEG directive, like CEND, 
indicates that succeeding locations are program-relocatable. The DSEG and 
AORG directives effectively terminate the common segment by beginning a data 
segment or an absolute segment. The END directive terminates the common 
segment and the program. 





CSEG Common Segment Directive CSEG 


Example 


COM1IA CSEG 'ONE' 
* COMMON RELOCATABLE SECTION, NAMED 'ONE' 


CEND 
* 
COM2A CSEG ‘TWO! 


* COMMON-RELOCATABLE SECTION, NAMED ‘Two! 


COM2B CEND 
COM1C CSEG ‘ONE! 


* 
COM1B CEND 
* 


COM1L DATA COMIB-COMIA LENGTH OF SEGMENT 'ONE' 
COM2L DATA COM2B-COM2A LENGTH OF SEGMENT 'TWO' 


This example illustrates the use of CSEG and CEND. The three blocks of code 
between CSEG and CEND are common-relocatable. The first and third blocks 
are relocatable with respect to one common relocation counter; the second is 
relocatable with respect to another. The first and third blocks constitute the 
common segment ‘ONE’; the value of the symbol COM1L is the number of words 
in this segment. The symbol COM2A is the symbolic address of the first word 
of common segment ‘TWO’; COM2B is the common-relocatable (type ‘TWO’) 
word address of the location following the segment. (Note that the symbols 
COM2B and COMIC are of different relocation types and possibly different 
values.) The value of the symbol COM2L is the number of words in common 
segment ‘TWO’. 


DATA. 


Syntax 


Description 


Example 
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Initialize Word Directive DATA 


[<label>] DATA <exp>[,<exp>] [<comment>] 


When used, a label is assigned the location where the assembler places the first 
word. 


DATA places one or more values in one or more successive words in program 
memory. The assembler evaluates each expression and places the value in a word 
as a 16-bit two’s-complement number. 


DATA should be used to place coefficients or other data words in program 
memory. During TMS320C25 execution, TBLR can be used to transfer the data 
words from program memory to data RAM. As many operands as desired may 
be used up to a total line length of 60 characters. 


KONS1 DATA 3200,1+'AB',-'AF',>F4A0,'A' 


DATA initializes five words, starting with a word at location KONS1. The contents 
of the resulting words are >OC80, >4143, >BEBA, >F4A0, and >0041. 





DEF 


Syntax 


Description 


Example 1 


Example 2 


External Definition Directive DEF 


[<label>] DEF <symbol>[,<symbol>] [<comment>] 


When used, a label is assigned the current value of the location counter. 


DEF makes one or more symbols available to other programs. All symbols used 
in the DEF statement must be defined in the same module. Each symbol defined 
in a program module and required by other program modules must be placed in 
the operand field of a DEF directive. A program named ‘ROUTINES’ that DEFs 
a routine named ‘SUBR1’ is shown below. The label ‘SUBR1’ must be defined 
in the program. 


De! "ROUTINES '! 
DEF SUBR1,SUBR2 


SUBR1 EQU g 
RET 

SUBR2 FOU 
RET 
END 

DEF ENTER,ANS 


This example causes the assembler to include symbols ENTER and ANS in the 
object code; these symbols are available to other programs. 


0001 0000 ABC EQU 0 
0002 0001 DEF EQU 1 

0003 0000 AORG 0 

0004 DEF ABC, DEF 
0005 END 


NO ERRORS, NO WARNINGS 
The object code for the above example is: 
KOOOONOSIDT 60000ABC 60001DEF 7F89AF 2.1 83.074 NOSIDT 1 


The symbol name follows the four-digit hexadecimal numbers assigned to the 
symbol by EQU. The number 6 preceding the 4-digit hexadecimal number is an 
object code tag. 
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DEND_ ____ Data Segment End Directive DEND 


Syntax 


Description — 
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[<label>] DEND [<comment>] 


- When used, a label is assigned the value of the location counter prior to modifi- 
cation. | 


DEND terminates the definition of a block of data-relocatable code by placing a 
value in the location counter and defining succeeding locations as program-re- 
locatable. DEND results in setting the location counter to one of these values: 


@ The maximum value attained by the location counter as a result of assembling 
any preceding block of program-relocatable code, or 


@ Zero, if no program-relocatable code has been previously assembled. 


If encountered in common-relocatable or program-relocatable code, DEND 
functions as a CEND or PEND, and a warning message is issued. Like CEND and 
PEND, DEND is invalid when used in absolute code. 


DORG Dummy Origin Directive DORG 


Syntax [<label>] DORG <exp> [<comment>] 


The label is assigned the value that the directive places in the location counter. 


Description DORG defines the succeeding locations as a dummy block or section. When 
| assembling a dummy section, the assembler does not generate object code but 
operates normally in all other respects. The result is that symbols that describe 
the layout of the dummy section are available to the assembler during assembly 
of the remainder of the program. Any symbol in the expression must have been 

previously defined. 


When the operand field is absolute, the location counter is assigned the absolute 
value. When the operand is relocatable, the location counter is assigned the 
relocatable value and the same relocation type as the operand. When this occurs, 
space is reserved in the section that has that relocation type. 


Example 1 DORG 0 


DORG causes the assembler to assign values relative to the start of the dummy 
section to the labels within the dummy section. 


Example 2 RORG 0 


(code as desired) 


DORG § 


(data segment) 
END 


This example directive defines a data structure for the executable portion 
(procedure division) of a procedure that is common to more than one task. The 
executable portion of the module (following a RORG directive) should use the 
labels of the dummy section as relative addresses. The code corresponding to the 
dummy section must be assembled in another program module. In this manner, 
separate data portions (dummy sections) are available to the procedure portion, 
regardless of the memory area into which the data is loaded. 


Example 3 CSEG ‘COME" 
DORG § "S$" HAS A COMMON-RELOCATABLE VALUE 
LAB1l DATA g 
MASK DATA >FOOO 
CEND 


DORG may also be used with data-relocatable or common-relocatable operands 
to specify dummy data or common segments. In this example, no object code is 
generated to initialize the common segment COM1, but space is reserved. All 
common-relocatable labels describing the structure of the common block 
(including LAB1 and MASK) are available for use throughout the program. 
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DSEG Data Segment Directive ___DSEG 


Syntax [<label>] DSEG [<comment>] 


When a label is used, it is assigned the data-relocatable value that the directive 
places in the location counter. | | | 


Description DSEG defines succeeding locations as data-relocatable. Either of these values 
is placed in the location counter: | 


@ The maximum value the location counter can attain as the result of assem- 
bling any block of data-relocatable code, or 


@ Zero, if no data-relocatable code has been previously assembled. 


DSEG defines the beginning of a block of data-relocatable code. The block is 
normally terminated with DEND. If several such blocks appear throughout the 
program, they constitute the data segment of the program. The entire data 
segment may be relocated independently of the program segment at link-edit time. 
This provides a convenient way to separate modifiable data from executable code. 


In addition to the DEND directive, PSEG, CSEG, AORG, and END properly 
terminate the definition of a block of data-relocatable code. PSEG, like DEND, 
indicates that succeeding locations are program-relocatable. CSEG and AORG 
effectively terminate the data segment by beginning a common segment (CSEG) 
or an absolute segment (AORG). END terminates the data segment as well as 
the program. 


Example RAM DSEG START OF DATA AREA 


<Data~-relocatable code> 


ERAM  DEND 


LRAM EQU ERAM ~ RAM 


The block of code between DSEG and DEND is data-relocatable. RAM is the 
symbolic address of the first word of this block; ERAM is the data-relocatable 
word address of the location following the code block. The value of the symbol 
LRAM is the length of words in the block. 


Caution: 


The TMS320C25 architecture provides separate data and program 
memory space, which results in two memory segments occupying 
the same address space. Data and program segment code must be 
distinguished. In particular, DATA and TEXT should not be used in 
DSEG to initialize an area within data memory. 


Data memory is volatile RAM and cannot retain information from 
one powerup to the next, so the proper way to initialize memory 
is by the execution of instructions in program memory on powerup. 
BSS or BES can be used within the DSEG to establish the size and 
names of variables, scalers, arrays, etc., in data memory. No other 
directives or instructions should be placed in a DSEG or CSEG. 
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END Program End Directive END 


Syntax [<label>] END [<symbol>] /<comment>/ 


When used, a label is assigned the current value of the location counter. 


Description END terminates the assembly. The last source statement of a program is the END 
directive. Any source statements or blank records following END are considered 
part of the next assembly. 


When used, the operand field contains a program-relocatable or absolute symbol 
that specifies to the link editor the entry point of the program. The entry point is 
the program address where execution of the assembled module begins. When 
the operand field is not used, no entry point is placed in the object code. If the 
entry point symbol is specified in the link control file, it must be REFed; otherwise 
the linker cannot find the entry symbol. 


Example AORG 0 
NOP 
ENTRY NOP 
END ENTRY 


The symbol ENTRY is assigned the value 1 by the assembler. Since ENTRY 
appears as the operand of END, the value of the symbol appears as a four-digit 
hexadecimal character 1, as seen in the sample printout below. 


Sample Printout: 


VALUE OF THE SYMBOL 


KOOOONOSIDT 90000B5500B5500100017F8A3F NOSIDT 
Example AORG >20 
ENTRY NOP 
END ENTRY 


The symbol ENTRY is assigned the value >20. As in Example 1, the value appears 
in the object code following the tag character 1, as shown in the sample printout 
below. 


Sample Printout: 
VALUE OF THE SYMBOL 


KOOOONOSIDT 90020B5500100207F9C7F NOSIDT 
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EQU Define Assembly-Time Constant Directive _ ____EQU 


Syntax [<label>] EQU <exp> [<comment>] 
The label field contains the symbol to be given a value. 


Description | EQU assigns a value to a symbol. <exp> may not contain a symbol appearing 
in a REF directive nor contain forward references. Symbols in the operand field 
must be previously defined. Certain symbols, such as ARO and PAO, have 
predefined values. 


Example 1 SUM EQU AR1 


The EQU directive assigns an absolute value to the symbol SUM, making SUM 
available as a register address. 


Example 2 TIME EQU HOURS 


This example assigns the value of the previously defined symbol HOURS to the 
symbol TIME. When HOURS appears in the label field of a machine instruction 
in a relocatable block of the program, the value is a relocatable value. After 
execution of EQU, the two symbols may be used interchangeably. 
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EXEC Independent Program Segment Directive EXEC 


Syntax [<label>] EXEC <pma> [<comment>] 


When used, a label is assigned the value that the directive places in the location 
counter. 


Description EXEC places the value <pma> in the location counter and defines succeeding 
locations as independently stored program segments. EXEC defines the beginning 
of a block of independent code. The block is terminated by XEND. Directives that 
affect the value in the location counter, such as BSS, cannot be used in the 
program segment defined by EXEC. Use of this type of directive terminates the 
EXEC segment. 


EXEC enables execution of a program segment at its actual loading address. The 
value placed in the location counter is the actual loading address of the inde- 
pendent segment. 


Example EXEC1 EXEC >1F40 


XEND 
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IDT __ -_ Program Identifier Directive IDT 


Syntax [<label>] IDT ‘<string>’ [<comment>] 
When used, a label assumes the current value of the location counter. 


Description IDT assigns a name to the object module produced. The operand field contains 
the module name <string>, a character string of up to eight characters within 
single quotes. When a character string of more than eight characters is entered, 
the assembler prints a truncation warning message and retains the first eight 
characters as the program name. 


Program modules to be linked by the link editor must include an IDT. The module 
names in the character strings of IDTs should be unique. The <string> on IDT 
is not automatically a DEFed symbol. 


Example 0001 IDT "EXAMPLE ' 
0002 0001 ONE EQU 1 
0003 0002 TWO EQU 2 


IDT assigns the name EXAMPLE to the module being assembled. The module 
name is then printed in the source listing as the operand of IDT and appears in 
the page heading of the source listing. The module name is also placed in the 
object code and is used by the link editor to determine the entry point for the 
module. The entry point must also appear as a symbol in a REF directive. 


Note: 


Uppercase letters and numerals are recommended within the quotes. The 


assembler accepts lowercase letters and special characters, but ROM loaders 
(for example) do not. | 
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LIST Restart Source Listing Directive LIST 


Syntax [<label>] LIST [<comment>] 


When used, the label assumes the current value of the location counter. 


Description LIST restores printing of the source listing. LIST is required only when UNL (stop 
source listing) is in effect and causes the assembler to resume listing. LIST is not 
printed in the source listing, but the line counter is incremented. The assembler 
does not print the comment. 


Example LIST 


The printing of the source listing is restored. 
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LOAD _ 


Syntax 


Description 


Example 
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Force Load Directive _ LOAD 


[<label>] LOAD <symbol>[,<symbol>] [<comment>] 
When used, a label is assigned the current value of the location counter. 


LOAD makes one or more symbols available to other programs. The LOAD 
directive is like DEF, except that the symbols need not be used in the module 
containing LOAD. The symbols used in LOAD must be defined in some other 
module during link edit time. LOADs are used with SREFs. If a one-to-one 
matching of LOAD and SREF pairs does occur, there will be no unresolved 
references during link editing. 


MODULE A1 MODULE A2 MODULE A3 
LOAD C, D LOAD C LOAD E, F 
MODULE B 


SREF C, D, E, F 
DATA C 


DATA D 
DATA E 
DATA F 





MODULE C MODULE D MODULE E MODULE F 


Module A(n) uses a branch table in module B to obtain one module: either C, 
D, E, or F. Module B has an SREF for C, D, E, and F. SREF does not require that 
symbols C, D, E, and F have corresponding symbols defined in another module, 
so modules need not be included in one link editing time. Module C has a DEF 
for C; module D has a DEF for D; module E has a DEF for E; and module F has 
a DEF for F. Module Ai has a LOAD for modules C and D; module A2 has a LOAD 
for module C; and module A3 has a LOAD for modules E and F. 


LOAD and SREF permit module B to be written to in order to handle a highly 
involved case and still be linked together without unnecessary modules. A(n) 
only has LOAD directives for its required modules. This is especially useful when 
developing large codes that may have more than a hundred modules. Not all 
modules are required to test a particular function. 


If the link control file included A1 and A2, modules C and D would be pulled in 
from a specified library while modules E and F would not. If the link control file 
included A3, modules E and F would be pulled in while modules C and D would 
not. If the link control file included A2, module C would be pulled in while 
modules D, E, and F would not. : 





LOAD Force Load Directive | | LOAD 


TASK TSTLOAD 
FORMAT ASCII 
PROGRAM 0O 
INCLUDE E:A1.MPO 
INCLUDE E:B.MPO 
FIND A:*.MPO 

END 


In this example using a PC/MS-DOS computer, the A:*.MPO is a selection of files 
that contain 990-tagged object modules for modules C, D, E, and F. In this case, 
only modules C and D are to be linked into the LOAD object module. 
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Description | 


Example 1 


Example 2 
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[<label>] MLIB ‘'<pathname>’ [<comment>] 


When used, a label assumes the current value of the location counter. 


MLIB provides the assembler with the name of a library containing macro defi- 
nitions. The operand of MLIB is a directory pathname (constructed according to 
the conventions of the host operating system) enclosed tn single quotes (see IDT 
and TITL directives). The operand field contains the pathname, a character string 
of up to 48 characters enclosed in single quotes; longer strings cause a truncation 
error message. 


MLIB 'DRC1: [PROJECT.STDMACS] ' 
MLIB 'DRC1: [PROJECT.DSPMACS]' 


When the program finds macro call SUBMAC (not previously defined), the above 
example causes the macro to search first for a file named: 


DRC1: [PROJECT .DSPMACS]SUBMAC.ASM 
Then, if that file is not found, the macro searches for a file named: 
DRC1: [PROJECT.STDMACS]SUBMAC.ASM 


in that order. 


MLIB 'DRCO: [MOORE.MACLIB] .ASM32' (VAX) 
MLIB 'A:' (MS-DOS VER 1.25) 


This example shows the typical use of MLIB on other systems. 


Note: 


On VAX/VMS systems, the filename of all files in the macro library must have 
an extension name of ”.ASM”. For example, if the statement: MLIB 
‘DRC1:[MACROS]’ has been used, the VAX/VMS version of the macro library 
processor would expect to find files such as MYMACRO.ASM, NEWMAC.ASM, 
etc., within the macro library 'MACROS’. 


On PC/MS-DOS systems, the filename of all files in the directory that are to 
be found as macros must not have an extension. For example, if the statement: 
MLIB ‘E:’ has been used, then the PC/MS-DOS version of the macro library 
processor would expect to find files such as MYMACRO, NEWMAC, etc., within 
the current level directory. 








OPTION Output Options Directive _OPTION 


Syntax [<label>] OPTION <option list> [<comment>] 


When used, the label assumes the current value of the location counter. 


Description OPTION selects several options for the assembler listing output. The <option- 
list> operand is a list of keywords, separated by commas, where each keyword 
selects a listing feature. The available <option-list> features are as follows: 


DUNLST: Limit the listing of DATA directives to one line. 

FUNLST: Turn off all list options. 

NOLIST: Inhibit all listing output (overrides LIST directive). 

SYMLST: Produce a symbol table list in the object file. 

TUNLST: Limit the listing of TEXT directives to one line. 

XREF: Produce a symbol cross-reference listing. 
Example OPTION XREF 


This example results in the production of a symbol cross-reference listing. 
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Description 


Example 
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[<label>] PAGE [<comment>] 


When-used, a label assumes the: current value of the location counter. 


PAG E causes the assembler to continue the source program listing on a new page. — 


PAGE jis not printed in the source listing, but the line counter is incremented. 


The assembler does not print the comment. Using PAGE to divide the source 


listing into logical divisions improves program documentation. 
PAGE > 


PAGE causes the assembler to list a next source statement as the first statement 
on a new page in the source listing. 


PEND Program Segment End Directive PEND 


Syntax [<label>] PEND [<comment>] 
When used, a label is assigned the value of the location counter prior to modifi- 
cation. . 
Description PEND ends a segment that is program-relocatable. This directive is provided as 


the program-segment counterpart to DEND and CEND. PEND, like DEND and 
CEND, places a value in the location counter and ends a segment that has defined 
succeeding locations as program-relocatable. Since PEND properly appears only 
in program-relocatable code, the relocation type of succeeding locations remains 
unchanged. 


The value placed in the location counter by PEND is the maximum value attained 
by the location counter as a result of the assembly of all preceding program-re- 
locatable code. PEND is invalid when used in absolute code. 


Example See PSEG. 
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Description 


Example 
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[<label>] PSEG [<comment>] 


When used, a label is assigned the value ‘hee the directive places in the location 
counter. 


PSEG places a value in the location counter and defines succeeding eaten’ as 
program- relocatable. The location counter is set to one of the following values: 


-@ The maximum value the location counter attained as a result of the assembly 


of any preceding block of program-relocatable code, or 
@ Zero, if no program-relocatable code was previously assembled. 


PSEG is provided as the program-segment counterpart to DSEG and CSEG. 
Together, the three directives provide a consistent method of defining the various 
types of relocatable segments. 


The following two sequences of directives are functionally identical: 


SEQUENCE 1 


DSEG 
<Data-relocatable code> 


DEND 
CSEG 


<Common-relocatable code> 


CEND 


SEQUENCE 2 


DSEG 
<Data-relocatable code> 
CSEG 


<Common-relocatable code> 


PSEG PSEG 
PEND 
END END 


REF 


Syntax 


Description 


Example 


External Reference Directive REF 


[<label>] REF <symbol>[,<symbol>] [<comment>] 


When used, a label is assigned the current value of the location counter. 


REF provides access to one or more symbols defined in other programs. Each 
symbol from another program module must be placed in the operand field of REF 
or SREF in the program module that requires the symbol. Below is a program 
named ‘MAIN’ that REFs a routine named 'SUBR1’. SUBR’7 is not defined in this 
file. 


IDT 'MAIN' 
REF SUBR1 
CALL SUBR1 
END 


If a symbol is listed in the REF statement, a corresponding symbol must also be 
present in a DEF statement in another source module. If a one-to-one matching 
of symbols does not occur, then an error occurs at link edit time. The link editor 
generates a summary list of all unresolved references. 


REF ARG1,ARG2 


This example causes the assembler to include symbols ARG1 and ARG2 in the 
object code so that the corresponding addresses may be obtained from other 
programs. 
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Description 


Example 1 


Example 2 


7-38 


| [<label> ] RORG | [[<exp>] /<comment>/] 


When a label is used, it is assigned the value that the directive places into the 
location counter. 


RORG defines succeeding locations as program-relocatable and initializes the 
location counter to either the value following the previous relocatable code of the 
program or to zero if no relocatable code has been previously assembled. 


Since the location counter begins at zero, the length of a segment and the next 
available address within that segment are identical. For example, if a segment 
begins at >O and ends at >E, the length is >F. The next available address is >F. 


When the operand field is used, the operand must be an absolute or a relocatable 
expression that contains only previously defined symbols. (Symbols are defined 
by the EQU directive.) When the operand field is not used, previous data segments 
and specific common segments of a program replace the value of the location 
counter. If RORG appears in absolute code, a relocatable operand must be 
program-relocatable. RORG changes the location counter to program-relocatable 
and replaces its value with the operand value. In relocatable code, the relocation 
type of the operand must match that of the current location counter. The operand 
value replaces the current location counter value, and the relocation type of the 
location counter remains unchanged. 


RORG $-10 OVERLAY TEN WORDS 


The $ symbol refers to the present location counter value. This has the effect of 
backing up the location counter by ten words. The instructions and directives 
following RORG replace the ten previously assembled words of relocatable code, 
permitting correction of the program without removing source records. If a label 
had been included, the label would have been assigned the value placed in the 
location counter. RORG would have no effect except at the end of an absolute 
block or a dummy block. 


SEG2 RORG 


The location counter contents depend upon preceding source statements. 
Assume that after defining data for a program that occupied >44 words, AORG 
initiated an absolute block of code. The absolute block is followed by the RORG 
directive from Example 1. This places >0044 in the location counter and defines 
the location counter as relocatable. Symbol SEG2 is a relocatable value, >0044. 


SREF Secondary External Reference Directive __SREF 


Syntax 


Description 


Example 


[<label>] SREF <symbol>[,<symbol>] [<comment>] 


When a label is used, the current value of the location counter is assigned to the 
label. 


SREF provides access to one or more symbols defined in other programs. Unlike 
REF, SREF does not require that a symbol have a corresponding symbol listed in 
a DEF statement of another source module. The SREFed symbol will be an 
unresolved reference, but is not included in the summary list of unresolved refer- 
ences. 


SREF ARG1,ARG2 


This example causes the assembler to include symbols ARG1 and ARG2 in the 
object code so that the corresponding addresses may be obtained from other 
programs. 
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TEXT 


Syntax 


Description 


Example 
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Initialize Text Directive TEXT 


[<label>] TEXT [-]’<string>’ [<comment>] 


‘When used, a label is assigned the location at which the assembler places the first 


character. 


TEXT places one or more characters of a string of characters in successive words 
of program memory. The assembler negates the last character of the string when 
the string is preceded by a unary minus (-) sign. The operand field contains a 
character string of up to 52 characters enclosed in single quotes, which may be 
preceded by a unary minus sign. 


MSG1 TEXT '‘'EXAMPLE' MESSAGE HEADING 


In this example, TEXT places the eight-bit ASCII character representations in 
memory and fills the unused byte of the last word with an ASCII space (>20). 
This space is considered as the last character if the negate option is specified. 
The result is >4558, >414D, >504C, and >4520. The labei MSG1 is assigned 
the first word’s address, which contains the value >4558. 


TITL Page Title Directive TITL 


Syntax [<label>] TITL ‘<string>’ [<comment>] 


When used, a label field assumes the current value of the location counter. 


Description TITL supplies a title to be printed in the heading of each page of the source listing. 
Unlike IDT, TITL is not printed in the source listing. When a title is desired in the 
heading of the listing’s page, TITL must be the first source statement submitted 
to the assembler. The assembler does not print the comment because TITL is not 
printed. The line counter is incremented. 


The operand field contains the title (string) and a character string of up to 50 
characters enclosed in single quotes. When more than 50 characters are entered, 
the assembler retains the first 50 characters as the title and prints a syntax error 
message. 


When TITL is the first source statement in a program, the title is printed on all 
pages until another TITL is processed. Otherwise, the title is printed on the next 
page after TITL is processed, and on subsequent pages until another TITL is 
processed. 


Example TITL '**REPORT GENERATOR**'! 


This example causes the title *“REPORT GENERATOR™* to be printed in the page 
headings of the source listing. 
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UNL Stop Source Listing Directive UNL 


Syntax [<label>] UNL [<comment>] 
When used, the label assumes the value of the location counter. 


Description | UNL halts the source listing output until the occurrence of a LIST directive. UNL 
‘Is not printed in the source listing, but the source line counter is incremented. 
UNL is frequently used in macro definitions to inhibit the listing of the macro 
expansion. The assembler does not print the comment. 


UNL can be used to reduce assembly time and the size of the source listing. 


Example NOPRINT UNL STOP LISTING 


The source listing is halted until a LIST directive occurs. 
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XEND Independent Segment End Directive _____sXEND 


Syntax [<label>] XEND [<comment> ] 


When used, a label is assigned the value placed in the location counter by the 
XEND directive. _ = 


Description XEND terminates the block definition of an independently stored program 
segment, previously defined by EXEC. The command field contains XEND. XEND 
results in setting the location counter to the value attained by the location counter 
before EXEC was issued, plus the difference between the most recent value in the 
location counter and the loading address of EXEC. 


Without using EXEC, a warning message is issued. 


Example See EXEC. 
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The source listings show the source statements and the resulting object code. Each 
page of the source listing has a title line at the top, on which is printed a title supplied 
by a TITL (title) directive. If TITL is not used, the title line is left blank. A page number 
is printed to the right of the title. The printer inserts a blank line below the title line 
and prints a line for each source statement listed. 


Each source statement line contains a source statement number, a location counter 
value, the assembled object code, and the source statement as entered. A source 
statement may result in more than one word of object code. The assembler prints the 
location counter value and object code on a separate line for each additional word. 
Each added line is printed immediately following the source statement line. Figure 
7-1 is an example of a source statement line. 


(SOURCE STATEMENT NUMBER IN DECIMAL) 
(LOCATION COUNTER VALUE IN HEXADECIMAL) 
(ASSEMBLED OBJECT CODE IN HEXADECIMAL) 
(LABEL FIELD) 
(COMMAND FIELD) 
(OPERAND FIELD) 
(COMMENT FIELD) 


| 


0070 O04A CAFF BEGIN LACK 255 LOAD ACCUMULATOR IMMEDIATE 


Figure 7-1. Source Statement Line Example 


The source statement number, 0070 in the example, is a four-digit decimal number. 
Source records are numbered in the order in which they are entered, including those 
source records that are not listed (e.g., TITL, LIST, UNL, and PAGE directives are 
not listed; source records between UNL and LIST are not listed). The difference 
between two source record numbers printed immediately in line indicates the number 
of source records entered and not listed. Source records generated by a macro call, 
however, are renumbered starting at line number 0001. The original line-numbering 
sequence continues after the macro expansion is complete. 


The next field in the source listing contains a hexadecimal location counter value. 
In the example, 004A is the location counter value. Since not all directives affect the 
location counter, the location counter field is blank for those directives that do not 
affect it, such as the IDT (program identifier), DEF (external definition), END 
(program end), EQU, REF, and SREF directives. 


The third field is the object code field which contains the hexadecimal representation 
of the object code, (>CAFF in the above example). All machine instructions and the 
DATA and TEXT directives use this field to list object code. The EQU directive places 
the value corresponding to the label in the object code field. 


The fourth field contains the characters of the source statement as they were scanned 
by the assembler. The maximum line length that the assembler will accept is 60 
characters. Spacing in this field is determined by the spacing in the source statement. 
The four fields contained in source statements are aligned in the listing only when 
they are aligned in the source statements or when tab characters are used. Each of 
the four fields must be separated by at least one blank space. 
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7.9 Object Code 


A major advantage of the TMS320C25 Macro Assembler is its ability to generate 
relocatable object code modules that can then be linked by the link editor to form 
an executable program. The ability to relocate modules simplifies the programming 
task. Programs designed as a set of modules are easier to code, test, and debug, and 
are also easier to understand and maintain. Relocatability also permits multiple 
programmers to work on a program’s components. Relocatable code includes 
information that allows a link editor to place the code in any available area of memory, 
thus providing the most efficient use of available memory. Absolute code must be 
loaded into a specified area of memory and cannot be moved. 


Object code generated by an assembler constitutes the assembled program, and 
consists of machine language instructions, addresses, and data. The code includes 
absolute, program-relocatable, data-relocatable, and common-relocatable segments. 


In assembly language source programs, symbolic references to locations within a 
relocatable segment are called relocatable addresses. These addresses are repres- 
ented in the object code as displacements from the beginning of a specified segment. 
A program-relocatable address, for example, is a displacement into the program 
segment. At load time, all program-relocatable addresses are adjusted by a value 
equal to the load address (the load address defines the beginning of the module). 
Data-relocatable addresses are represented by a displacement into the data segment. 
There may be several types of common-relocatable addresses in the same program, 
since distinct common segments may be relocated independently of each other. 


The assembler produces object code that may be linked to other object code modules 
Or programs, and is loaded directly into the processor. Object code consists of records 
containing up to 71 ASCII characters. Corrections on record data can be made via 
a keyboard, making reassembly unnecessary. Figure 7-2 is an example of object code. 


KOOOOFACT 91006BCA0D1BE000BCAD1B6001BCA02B6002BCA0 3B6003B3C037F240F FACT 
BAOO2BCE14B600 3BCA04B6004B3CO4BA00 3BCE14B6004B3CO4BA003BCE14B60047F16BF FACT 
BCAO5B6005B3CO5BA0D04BCE14BO005B3CO5BA00 3BCE14B6005B3CO5BA0O02BCE147F151F FACT 
BOOO5BCA0D6B6O0GB3COGBADO05BCE14B6006B3CO6BA0D04BCEL14BO006B3CO6BA0037F169F FACT 
BCE 14B6006B3COOBA002BCE14B6006BCA0N7B6007B3CO7BAQOOOBCE14B6007B3CO77F14BF FACT 
BAOO5BCE14B6007B3CO7BA0O04BCE14B6007B3CO7BA0O03BCE14B6007B3CO7BAOO027F158F FACT 
BCE14B60077FD8BF FACT 
: FACT 8/7/84 16:42:51 ASM32020 0.6 84.140 FACT 


Figure 7-2. Sample Object Code 


7.9.1 Object Code Format 


Object code is formatted to contain records made up of fields sandwiched between 
tag characters. Table 7-8 lists field and tag character information. 


A tag character occupies the first position on each record of object code and identifies 
the fields it precedes. The specific tag character used depends on the function of the 
field with which it is associated. The following paragraphs detail the various tag 
characters and their associated fields. 


Tag character K is placed at the beginning of each program and is followed by two 
fields. Field one contains the number of words of program relocatable code; field two 
contains the program identifier assigned to the program by an IDT directive. When 
no IDT is entered, NOSIDT is put into field two. The link editor uses the program 
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identifier to identify the program, and the number of words of program-relocatable 
code to determine the load bias for the next module or program. 


The tag character M is used when data or common segments are defined in the 
program and is followed by three fields. Field one contains the length, in words, of 
data- or common-relocatable code; field two contains the data or common segment 
identifier; and field three contains a common number. The identifier is a six-character 
field containing the name $DATA (padded on the right by one blank) for data 
segments and $BLANK for blank common segments. If a named common segment 
appears in the program, an M tag appears in the object code, with an identifier field 
corresponding to the operand in the defining CSEG directive(s). Field three of the 
M tag consists of a four-character hexadecimal number defining a unique common 
number to be used by other tags referencing or initializing data of that particular 
segment. For data segments, this common number is always zero. For common 
segments (including blank common), common numbers are assigned in increasing 
order. The maximum number of common segments that a program may contain Is 
127. | 


Tag characters 1 and 2 are used with entry addresses. The associated field is used 
by the linker to determine the entry point where execution starts when linking is 
complete. Tag character 1 is used when the entry address is absolute; tag character 
2 is used when the address is relocatable. The field lists the address in hexadecimal. 


Tag characters 9, A, S, and P are used with load addresses required for data words 
to be placed at other than the next immediate memory addresses. Tag character 9 is 


~ used when the load address is absolute; A when the load address is program-relo- 


catable; S when the load address is data-relocatable; and P when the load address 
is common-relocatable. Field one contains the load address. Field two is only used 
with P and contains the common number. 


Tag characters B, C, T, and N are used with data words. Tag character B is used 
when the data is absolute (i.e., an instruction word or a word containing text char- 
acters or absolute constants). B is used for absolute word data (16 bits). Tag 
character C is used for a word containing a program-relocatable address; tag char- 
acter T for a word containing a data-relocatable address; tag character N for a word 
containing a common-relocatable address. Field one contains the data word. The 
linker places the data word in the memory location specified in the preceding load 
address field or in the memory location that follows the preceding data word. Field 
two is only used with N and contains the common number. 


Tag characters #, %, and & are also used when an instruction’s multibit field refers 
to a data element in a DSEG, PSEG, or CSEG. Tag character # identifies an instruction 
containing a reference to a multibit data-relative item. The second field following 
the tag contains a mask indicating to the link editor the width of the field (mask = 
>007F indicates the least significant 7 bits). The link editor generates the final version 
of this instruction by adding the beginning location of the data segment to the 
masked data word, and re-inserting the sum in the multibit field within the data word. 
Note that field overflow may occur in the link edit operation, and error messages 
may be generated that were not evident at assembly time, which may give unpre- 
dictable results. The description of the % tag is the same as above, except that it 
represents the use of a program-relative item as the operand. The fields used with 
the & tag are identical to the # and % tags, except that the second field is the common 
number, and the mask becomes the third field. 


Tag characters 5, 6, and W are used for external definitions. Tag character 5 is used 


when the location is program-relocatable; 6 when the location is absolute; and W 
when the location is data- or common-relocatable. The link editor uses the fields 
to provide the desired linking to the external definition. Field one contains the 
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location of the last appearance of the symbol; field two contains the symbol of the 
external definition; and field three of tag character W contains the common number. 


Tag character 4 is used for external references when the last appearance of the 
externally referenced symbol is in absolute code. Tag character 4 is associated with 
two fields: field one contains the location of the last appearance of the symbol, and 
field two contains the symbol itself. 


Tag character E is used for external references. An E tag is used when a non-zero 
quantity is added to a reference. Field 1 identifies the reference by occurrence in the 
object code (0, 1, 2, ...). In other words, the value in field one is an index to references 
identified by the 4 and Y tags in the object code. The list.is maintained by order of 
occurrence (i.e., the first entry in the list is the symbol located in field two of the first 
4 or Y tag). Field 2 contains the value to be added to the reference after the reference 
is resolved. 


Tag character ! is used when a multibit field of an instruction refers to an external 
reference. The format of the ! sequence is: 


! (external symbol number) (opcode/offset) (mask) 
This tag and its associated fields are processed the same as that of the # tag. 


Tag characters G, H, and J are used when the symbol table option (see the OPTION 
directive) is specified. Tag character G is used when the location or value of the 
symbol is program-relocatable; H when the location or value of the symbol is abso- 
lute; and J when the location or value of the symbol is data- or common-relocatable. 
Field one contains the location or value of the symbol; field two contains the symbol 
to which the location is assigned; field three is used only with tag character J and 
contains the common number. 


Tag character U is generated by the LOAD directive. The symbol specified is treated 
as if it were the value specified in an INCLUDE command to the loader. Field one 
contains zeroes, and field two contains the symbol for which the loader will search 
for a definition. 


Tag character Y is used for secondary external references when the last appearance 
of the externally referenced symbol is in absolute code. Tag character Y is associated 
with two fields: field one contains the location of the last appearance of the symbol, 
and field two contains the symbol itself. 


Tag character 7 precedes the checksum, and is placed at the end of the set of fields 
in the record. The checksum is an error detection word formed as the record is being 
written. The checksum is the two’s complement of the sum of the characters’ 8-bit 
ASCII values from the first tag of the record through the checksum tag (tag character 
7). 


Tag character 8 is also associated with the checksum field but is used when the 
checksum field is to be ignored (as when changing the object code). 


Tag character D, used to specify a load bias, has an associated field containing the 
absolute address used by the loader to relocate symbols. The link editor does not 
accept the D tag. 


Tag character F is placed at the end of the record, and it may be followed by blanks. 


The end of each record is identified by the tag character 7, followed by the checksum 
field and tag character F. The assembler fills the rest of the record with blanks and 
a sequence number, and begins a new record with the appropriate tag character. 
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The last record of an object module has a colon (:) in the first character position of 
the record, followed by the module name, assembly date, and assembly time. | 


Table 7-8 defines the object record format and tags. 


Table 7-8. Object Record Format and Tags 


1ST FIELD 2ND FIELD 3RD FIELD 


(MODULE DEFINITION) 


PSEG LENGTH PROGRAM 1!D(8) 

DSEG LENGTH | $DATA 0000 
BLANK COMMON $BLANK COMMON # 
LENGTH 

CSEG LENGTH COMMON NAME(6) COMMON # 


(ENTRY POINT DEFINITION) 


ABSOLUTE ADDRESS 
_P-R ADDRESS 
(LOAD ADDRESS) 


ABSOLUTE ADDRESS 

P-R ADDRESS 

D-R ADDRESS 

C-R ADDRESS COMMON # 


(DATA WORD) 


ABSOLUTE 16-BIT 

VALUE 

P-R ADDRESS 

D-R ADDRESS 

C-R ADDRESS COMMON # 
OPCODE/DR ADDRESS MASK 
OPCODE/PR ADDRESS MASK 


OPCODE/CR ADDRESS COMMON # 
(EXTERNAL DEFINITIONS) 


ABSOLUTE VALUE SYMBOL(6) 
P-R ADDRESS SYMBOL(6) 
D-R/C-R ADDRESS SYMBOL(6) COMMON # 


(EXTERNAL REFERENCES) 


ABSOLUTE ADDRESS SYMBOL (6) 

OF CHAIN 

SYMBOL INDEX ABSOLUTE OFFSET 
NUMBER 

SYMBOL INDEX OPCODE/OFFSET 
NUMBER | 


(SYMBOL DEFINITIONS) 


P-R ADDRESS SYMBOL(6) 
ABSOLUTE VALUE SYMBOL(6) 
D-R/C-R ADDRESS SYMBOL(6) COMMON # 
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Table 7-8. Object Record Format and Tags (Concluded) 


TAG 
[0006 


Y ABSOLUTE ADDRESS SYMBOL(6) 
OF CHAIN 


ie 
lanyvaEOOOC“‘“‘SCS*rYSONSCSCOCOC~C“SSC*~‘“S 

[ABSOLUTEADDRESS OCS CSC“~*~*S 
7 Gee 
[1 [ P-R ADDRESS [PROGRAMID(@) Sd 


NOTES: 1. All field widths are four characters unless otherwise specified. 
lf the first tag is >01, the file is in compressed object format. 
P-R denotes program segment, relative address. 

D-R denotes data segment, relative address. 

C-R denotes common segment, relative address. 
















e 





wis 


7.9.2 Changing Object Code 


Object code may be corrected without reassembling a program by changing or adding 
one or more records. One additional tag character is recognized by the loader to 
permit specifying a load point. The additional tag character, D, may be used in object 
records changed or added manually. 


Tag character D is followed by a load bias (offset) value. The loader uses this value 
instead of the load bias computed by the loader itself. The loader adds the load bias 
to all relocatable entry addresses, external references, external definitions, load 
addresses, and data. The effect of tag character D is to specify that area of memory 
into which the loader loads the program. The tag character D and the associated field 
must be placed ahead of the object code generated by the assembler. 


Correction of the object code may only require changing a character or a word in 
an object code record. Records may be duplicated up to the character or word in error. 
Then the correct data replaces the incorrect data, and the remainder of the record 
up to tag character 7 is duplicated. When the checksum is verified as the record ts 
loaded, the changes made cause a checksum error. The tag character 7 should be 
changed to 8. This causes the checksum error resulting from the record change to 
be ignored. 


When more extensive changes are required, an additional object code record(s) may 
be written. Each record is begun with a tag character 9, A, S, or P (load address tag 
characters), followed by an absolute load address or a relocatable load address. This 
may be an address into which an existing object code record places a different value. 
The new value on the new record overrides the old value when the new record 
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follows the old record in the loading sequence. The load address is followed by a 
tag character B, C, T, or N (data word tag characters) and an absolute data word 
or a relocatable data word. Additional data words preceded by appropriate tag 
characters may follow. When additional data is placed at a nonsequential address, 
another load address tag character is written followed by the load address and data 
words preceded by tag characters. When the record is full, or all changes have been 
written, tag character F is written to end the record. 


When additional memory locations are loaded as a result of changes, field one of tag 
character K containing the number of words of relocatable code must be changed. 
For example, if the object field written by the assembler contained 1000 hexadecimal 
words of relocatable code and the change has added eight words in a new object 
record, additional memory locations will be loaded. In the object code file, the value 
following the tag character K is changed from 1000 to 1008. The tag character 7 is 
also changed to 8 in that record. 


When added records place corrected data in locations previously loaded, the added 
records must follow the incorrect records. The loader processes the records as they 
are read from the object medium. The last record that affects a given memory location 
determines the contents of that location at execution time. 


The object code records that contain the external definition fields, the external 
reference fields, the entry address field, and the final program start field, must follow 
all other object records. An additional field or record may be added to include 
reference to a program identifier. The tag character is 4, and the hexadecimal field 
contains zeros. The second field contains the first six characters of the |IDT character 
string. External definitions may be added using tag character 5 or 6, followed by the 
relocatable or absolute address, respectively. The second field contains the defined 
symbol, filled to the right with blanks when the symbol contains less than six char- 
acters. 


7.10 Cross-Reference Listing 


The assembler prints an optional cross-reference listing following the source listing. 
(The cross-reference listing is created by using the OPTION directive.) The format 
of the listing is shown in Figure 7-3. 


LABEL VALUE DEFN REFERENCES 


BASE2 O029B 0095 

BC 0236 0009 0003 0025 0030 0035 0060 0061 0064 0067 0069 
BCDONE REF 0004 0082 0084 0086 0088 0090 0092 0094 

CTXTO O023B 0014 0020 £0079 

CTXT1 023C 0015 0021 0077 

CTXT2 O23D 0016 0022 0078 

TORT SREF 0005 
IORTIB UNDF 7 0039 0043 
IORTIF 0256 0040 0028 
IORT2F O25B 0044 0036 
IORT3F O281 0076 0072 
IORTB1 0298 0093 0058 
IORTB2 0295 0091 0055 
IORTB3 0292 0089 0052 
IORTB4 O28F 0087 0049 


Figure 7-3. Cross-Reference Listing Format 
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As shown in Figure 7-3, the assembler prints in the LABEL column each symbol 
defined or referenced in the assembly. The VALUE column contains a four-digit 
hexadecimal number and is possibly followed by either a character or a name that 
represents the attributes of the symbol. A four-digit hexadecimal number represents 
the value assigned to the symbol. The characters following the four-digit number or 
the names that may be in the VALUE column have their meanings listed in Table 7-9. 
The number of the statement in which the symbol is defined appears in the DEFN 
(definition) column. For undefined symbols, this column is left blank. The REFER- 
ENCES column lists the number of statements that reference the symbol. A blank in 
this column indicates the symbol was defined but never used. 


Table 7-9. Assembly Symbol Attributes 


CHARACTER 
OR NAME 


External reference (REF) 
Undefined 


Secondary reference (SREF) 

Symbol defined in a program segment 
Symbol defined in a data segment 
Symbol! defined in a common segment 





7.11 Assembler Error Messages 
The assembler issues the following three types of error messages: 


@ Nonfatal 
® Fatal 
@ Informative 


When the assembler completes an assembly, it indicates any errors it encounters in 
the assembly listing. The assembler indicates errors following the source line in which 
they occur. The errors are referenced by number. At the end of a module (as delin- 
eated by the IDT/END directive pair), the corresponding messages are printed. Table 
7-10 lists non-fatal error messages, and Table 7-11 lists fatal messages. In Table 
7-12, assembly information messages are given. 
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Table 7-10. Non-Fatal Error Listing 


[__wsseaoe__[__exnananowmesronse 


WARNING - ‘DSEG’ ASSUMED This is a warning that the following two statements have the same result: 
CSEG 'DATA' 
DSEG 


WARNING - SYMBOL TRUNCATED The maximum length for a symbol is 6 characters. The assembler ignores the | 
extra characters. 

WARNING - STRING TRUNCATED Check the syntax for the directive question to determine the maximum length 
for the string. 

WARNING - TRAILING OPERAND(S) The assembler found fewer or more operands than expected in the flagged 
instruction. 

WARNING - BYTE VALUE TRUNCATED | A value to be used as a byte is larger than can be loaded into the space for a 
| byte. 

WARNING - NULL STRING DEFINED An empty string (i.e., length = 0) is defined for string input, for directives 
that require a null string operand. 




































7-52 





Assembler Directives 


Table 7-11. Fatal Error Listing 


EXPLANATION/RESPONSE 


A relocatable symbol was used where an absolute symbol was 
expected. 


ABSOLUTE VALUE REQUIRED 


DISPLACEMENT TOO BIG 
INVALID EXPRESSION 
EXPRESSION OUT OF BOUNDS 
DUPLICATE DEFINITION 


The maximum value of the operand was exceeded. 
This may indicate invalid use of a relocatable symbol in arithmetic. 


Range limit for the value of the operand was exceeded. 


The symbol appears as an operand of a REF statement, as well as 
in the the label field of the source, or the symbol appears more than 
once in the label field of the source. 





INVALID RELOCATION TYPE 
INVALID OPCODE 


An absolute variable cannot be made relocatable. 


The command field of the source record has an entry that is not a 
defined instruction, directive, or macro. 


The option given in the OPTION directive is invalid. An option is 


INVALID OPTION 





often misspelled. 


INVALID REGISTER VALUE The register specified is too large or too small. Only values of O to 


4 are allowed for ARO to AR4, respectively. 


INVALID SYMBOL The symbol has invalid characters in it. 


VALUE TRUNCATED 


The value is too big for the field and has been truncated. This 


message also appears when a label string exceeds its maximum 
length. 


File does not exist or is already being used. 





SYMBOL USED IN BOTH REF AND DEF 
COPY FILE OPEN ERROR 


EXPRESSION SYNTAX ERROR Unbalanced parentheses or invalid operations on relocatable 
symbols. 


The directives PEND, DEND and CEND have no meaning in abso- 
lute code. 


INVALID ABSOLUTE CODE DIRECTIVE 


LABEL REQUIRED 
BLANK MISSING 
COMMA MISSING 


The flagged directive must have a label. 
A blank or blanks must separate each field of the source statement. 


Expected a comma but did not find one. Usually means that more 
operands were expected. 


COPY FILENAME MISSING 
SYMBOL REQUIRED 


Filename specified cannot be found. 


OPTION, DEF, REF, SREF, and LOAD directives require symbols 
as operands. 


OPERAND MISSING 

CLOSE (’) MISSING 

CLOSE (’)’) MISSING 

STRING REQUIRED 

PASS1/PASS2 OPERAND CONFLICT 


An operand must be supplied. 

All strings must be enclosed in quotes. 
Mismatched parenthesis. 

TEXT directive used with no text following. 


A symbol in the symbol table did not have the same value in PASS1 
and PASS2. 


Error in syntax. 


The symbol has not been REFed, or it has been DEFed but not 
used. 


SYNTAX ERROR 
UNDEFINED SYMBOL 


DIVIDE BY ZERO 
ILLEGAL SHIFT COUNT 


An expression or well-defined expression contains invalid division. 


The shift count requested is not valid. 


~ 
1 

O1 

GO 
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Table 7-12. Assembly Information Message Listing 


[| MESSAGE EXPLANATION/RESPONSE | | 


OPCODES REDEFINED | | As a result of an MLIB directive, one or more assembler opcodes 


have been redefined by a MACRO within a MACRO directory. The 
MACROS REDEFINED 








user should take action if this is not intended. 


As a result of an MLIB directive, one or more currently defined 
MACROS have been redefined by a MACRO (of the same name) 
within a MACRO directory. The user should take action if this is 
not intended. : 
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8. Assembler Macros 


The TMS320C25 Macro Assembler supports macro calls and definitions along with 
macro-conditional assembly for simplifying programming and_ consolidating 
frequently repeated source code. Macros may be defined with the assembler input 
or in a library (directory) of external files to be included at link time. 


Major topics discussed in this section are listed below. 


@ Macro Definitions (Section 8.1 on page 8-2) 
Sample macros 
Macro assembly language elements: 
- Labels (Section 8.2 on page 8-5) 
- Strings (Section 8.3 on page 8-5) 
- Constants (Section 8.4 on age 8-5) 
- Variables (Section 8.5 on page 8-5) 
- Operators (Section 8.6 on page 8-9) 
- Keywords (Section 8.7 on page 8-10) 
- Verb statements (Section 8.8 on page 8-11). 


© Model Statements (Section 8.9 on page 8-17) 
@ Macro Examples (Section 8.10 on page 8-18) 


@ Macro Error Messages (Section 8.11 on page 8-20) 
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8.1 Macro Definitions 
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The TMS320C25 Macro Assembler recognizes a macro definition language that is 
used to simplify programming. A macro definition is a set of source statements 
(machine instructions, macro statements, and assembler directives), which constitute 
a template for generating other statements within a source program. Macro defi- 
nitions consist of model statements and statements containing macro verbs. They 
are used to define macros and macro variables and to determine which model 
statements are assembled. | 


When the assembler processes a macro call, it substitutes the predefined statements 
of the macro definition for the macro call statement in the source program, and 
assembles the substituted statements as if they had been included in the source 
program. 


Macro definitions are usually created by including lines of code in a predefined format 
within the assembler source file. In general, this format requires a symbolic line 
marking the start of a macro definition. The macro name is placed in the line’s label 
field, and the string ‘SMACRO’ is placed in the operand field. A list of formal 
parameters separated by commas may be placed in the operand field. 


The elements of the macro assembly language are labels, strings, constants, variables, 
operators, keywords, and verbs. A macro definition consists of model statements 
and statements containing macro verbs used to define the macro and macro variables 
and determine which model statements are assembled. All macro statements that 
do not contain verbs are processed as model statements. A model statement results 
in an assembly language source statement. 


Macros may be defined in-line with the normal assembler source code, provided that 
the macro definition appears before that macro is called. Macro definitions are usually 
placed at the top of the assembler source file. This allows easy reference to the macro 
definitions since they are in one location. 


Macros may also be defined in external files. These files are simply text files (like the 
assembler source file) that contain macros defined in the same manner as those 
defined in the main assembler source file. Only one macro may be defined in a file. 
The assembler is informed of the existence of a macro library (i.e., a collection of 
macro files) by means of the MLIB directive (see Section 7.6.5). An example of the 
use of the MLIB directive is: 


MLIB 'E:' 


The string enclosed in the quotes represents a directory name in the format required 
by the host operating system. 


To illustrate the use of a macro library, a library of macro definitions is assumed to 
be contained in a directory named ’E:’ and a file named ‘CPXADD*‘ that is a member 
of that directory. If the macro call 


LABEL CPXADD CX1,CX2 


is found in the assembler source, the in-memory macro table is first searched for the 
definition of CPXADD. CPXADD will be in the macro table if CPXADD was previously 
defined in the assembler source file or was previously encountered and read from a 
macro file. If the definition is not found in the macro table, a search of the normal 
assembler opcode/directive table is made. If found in the assembler opcode/directive 
table, the opcode is assembled as a normal machine instruction. If not, an attempt 
is made to find the file whose name is formed by appending the macro name to the 
MLIB name. If more than one MLIB directive has been encountered, the most recently 
defined library is searched first; then all remaining libraries are searched. If the file 
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is found, the macro definition is copied into the assembler’s macro file (in a 
compressed format), and an entry is made in the macro table for later use. 


Because of the sequential search for matching definitions (library search following 
the opcode/directive table search), a macro defined in a library will not automatically 
redefine a machine instruction, although this is easily done using an in-line macro 
definition. To extend this capability to the macro library, that library should include 
a text file named ‘MLIST’, which contains the names of the opcodes and currently 
defined macros (one name per line, starting with column one) which are to be 
redefined. 


A typical MLIST file may be constructed as follows, using the appropriate system text 


editor: 
file name <MLIB directory name>. MLIST 
record 1 ADD (opcode) 
record 2 LACK (opcode) 
record 3 DMOV (opcode) 
record 4 FSUB (macro) 
eof (MLIST) 


This MLIST file is read when the MLIB directive is processed. If a name found there 
matches a currently defined opcode or a name in the macro table, the matching entry 
is removed from its table. This forces a search of the libraries, since the name will 
not be found elsewhere. When a name is found matching an opcode, the message: 


' **** OPCODES REDEFINED' 


is printed in the assembler listing, following the printing of the MLIB statement. A 
similar message: 


' *#*** MACROS REDEFINED' 


appears when currently defined macros are redefined. If this is intended, then no 
action is required; if not, then some action is necessary, such as the deletion of some 
or all of the records in the MLIST file. 


The name of a macro in file should be the same as the file name; otherwise, some 
inefficiency in macro usage will result. If the file named CPXADD contains a definition 
line such as: 


CPXMUL SMACRO MR, MD 


an entry for a macro named CPXMUL will be made in the internal macro table. The 
next call to CPXADD will be recognized as undefined and reentered into the internal 
macro table as CPXMUL. 


Note that the use of an MLIST file to override the assembler opcode table can result 
in unpredictable behavior of the assembler. Care should be taken in using this option. 
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8.1.1 Sample Macros 
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The following example defines a macro named INCX. $MACRO identifies the 


beginning of the macro definition, and SEND identifies the end of the macro defi- 


nition. LACK 1, ADD X, and SACL X are model statements which will be placed into 
the source program upon a macro call. The macro INCX may be used in the source 
program as often as necessary. 


INCX SMACRO 
LACK 
ADD 
SACL 
SEND 


. eee 


The macro INCX may be called by simply placing the line INCX within the source 
file. The macro assembler will replace this line with the remainder of the definition, 
1.@.: | 


LACK L 
ADD X 
SACL X 


X must be a symbol representing a memory address in the source program assigned 
by the EQU directive. INCX is limited because the macro can only be used with the 
single memory location X. The INC macro can be used with any memory location: 


INC SMACRO M 
LACK 1 
ADD 2-M.S: 
SACL >M.S:3 
SEND 


M is a macro parameter that is replaced by the actual parameter when the macro is 
called. M.S is the string component of this variable, i.e., the symbol representation 
of the variable. For example, the line INC Y will be replaced by: 


LACK 1 
ADD x 
SACL Y¥ 


Likewise, INC Z will be replaced by: 


LACK 1 
ADD L 
SACL Z 


Another component of a macro variable is the value component, as shown in the 
following example: 


ADDK SMACRO X,NUM X and NUM are parameters. 


LACK >NUM.V: NUM V is the value component 
of parameter NUM. 

ADD tXeos : 

SACL . eas 

SEND 


The macro call ADDK Y,3 will result in: 


LACK 3 
ADD Y 
SACL Y_ 
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8.2 Labels 


A macro label consists of one to six characters. The first character must be alphabetic, 
optionally followed by alphanumeric characters. Macro labels are used to determine 
the sequence of processing of statements in a macro definition when the statements 
are not to be processed in order. 


Examples of valid macro labels: 


Li 
NATPNT 


C 


8.3 Strings 


Macro strings consist of one or more characters with enclosing quotes. Macro strings 
are defined in the same manner as the character string used in the assembly language 
source statement (see Section 7.4). 


Example of strings: 
"ONE! 


' (three blank spaces) 


8.4 Constants 


Constants for macros are defined in the same manner as constants in the assembly 
language source statements (see Section 7.3). 


Examples of constants: 


>9OF3C 


S$ (current location counter value) 


8.5 Variables 


Variables are symbols, used within a macro, which take on values through various 
mechanisms in the macro definition language. The maximum length of a variable is 
six characters. Macro variables are strictly local, i.e., they are available only to the 
macro that defines them. Macro $VAR (variable declaration verb) statements declare 
variables for a macro definition. 


The macro assembly language permits concatenation of macro variable components 
with strings, characters of model statements, and other macro variables. Variables 
are represented in the same manner as symbols in the Assembler Symbol Table (AST). 
This table maintains all the references to the variables, symbols, and labels used. 
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8.5.1 Parameters 


Parameters are macro variables that are declared in the $MACRO (macro definition 
verb) statement at the beginning of the macro definition. The sequence of parameters 
in the operand field of the S$MACRO statement corresponds to the sequence of 
operands in the operand field of the macro call. In the expansion of a macro call, 
the parameters have values that are associated with the corresponding operands in 
the macro call. 


Examples of SMACRO statements with parameters: 
LABEL SMACRO AyB3 


NAME  S$MACRO O,RC,AMT 


8.5.2 Macro Symbol Table (MST) 
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The macro translator maintains a Macro Symbol Table (MST) similar to the Assembler 
Symbol Table (AST). Each entry consists of four components: string, value, length, 
and attributes of a variable or parameter. The macro assembler places parameters in 
the MST while processing a macro call. Variables are placed in the MST as the 
assembler processes the macro $VAR statements that declare variables. 


An entry’s string component in the MST contains a character string assigned to the 
macro variable or parameter by the macro expander. The value component contains 
the numerical equivalent of the string component if the string component is an 
integer. The value component can also contain the numerical value of the symbol 
if the string component is a symbol in the AST. 


If a parameter is an operand list, the value is the length of the list. The length 
component contains the number of characters in the string component. The attribute 
component of the MST is a bit vector, the bits of which correspond to the attributes 
of the variable or parameter. 


Macro definition example: 


ADDK ae X,NUM The SMACRO directive defines the beginning of the defi- 
nition of the macro ADDK with parameters X and NUM. 


Macro call example: 
ADDK VAR1,3 


With the MST now containing parameters X and NUM, the string component of 
parameter X is the character string VAR1. The attribute component indicates that the 
parameter is supplied in a macro call. The length component is four. The string 
component of parameter NUM is the ASCII character 3. The value component is three 
(expressed as a binary number) and the length component is one. The attribute 


component indicates that the parameter is supplied in the macro call. 


Each macro variable component may be accessed individually. Reference to a vari- 
able component is made in either binary mode or string mode. In the binary mode, 
the referenced macro-variable component is treated as a signed 16-bit integer. Binary 
mode access is made by writing the variable name and component. When a reference 
is made to the string component of a macro variable in binary mode, the 16-bit integer 


_ value of the ASCII representation of the first two characters of the string is obtained. 


In the macro definition and call examples above, the binary-mode value of the string 
component of X is >5641, which is the ASCII representation for VA. 
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String-mode access of macro-variable components is signified by enclosing the 
variable in a pair of colons, e.g., :X:. Colons are always used in pairs to enclose a 
variable name. If a component qualifier is used, the pair of colons enclose the entire 
qualified name. 


8.5.3 Variable Qualifiers 


Parameter or variable components may be specified using the names shown in Table 
8-1. The variable name is followed by a period ’.’ and a single-letter qualifier. The 
following examples refer to previous macro examples using ADDK. 


Examples of qualified variables: 


X.S String component of variable VAR1. X.S equals the binary equivalent for 
VA or >5641. Astring mode indicated as :X.S: is equal to the string ‘VAR1’. 


X.A Attribute component of variable X. This component may be accessed by 
use Of logical operators and attribute keywords (described in Table 8-3). 


X.V Value component of variable X. 


X.L Length component of variable X. In the first example of the macro call for 
the macro ADDK;,:X.L: = 4. 


Table 8-1. Variable Qualifiers 


QUALIFIER] MEANING 


The string component of the variable 
The attribute component of the variable 
The value component of the variable 

The length component of the variable 









If a variable is not followed by a period ’.’ and a single-letter qualifier, it is referred 
to as an unqualified variable. Except in an $ASG statement, an unqualified variable 
defaults to the string component of the variable. In the two following examples, the 
concatenated strings are equivalent: 


Example 1: :-CT.S:"WAY’' Variable CT qualified 


Example 2: :CT:’WAY’ Variable CT unqualified 
In model statements, binary references to macro variables MUST be qualified. 


All symbols in the Assembler Symbol! Table (AST) have symbol components. (All 
components of macro parameters and the values of all AST symbols are directly 
accessible.) In order for other components to be accessed in a macro, the symbol 
must be assigned to the string component of a macro variable, using $ASG (value 
assignment verb). The additional qualifiers shown in Table 8-2 may be used with 
the macro variable to access the symbol components of the AST symbols. 
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Table 8-2. Variable Qualifiers for Symbol Components 


QUALIFIER me MEANING 4 


SS String component of a symbol that is 
the string component of a variable | 








SV Value component of a symbol that is 
the string component of a variable | 


SA Attribute component of a symbol that 
is the string component of a variable 


Length component of a symbol that is 
the string component of a variable 


Assuming that V1.8 is defined as MASK and the statement MASK EQU >FF has 
been previously encountered in the assembly language source program, the following 
examples of qualified variables specify symbol components of string components of 
variables: | | 


V1.SS String component of the symbol MASK. Null unless a macro instruction 
has caused a string to be associated with it by using a $ASG statement. 


V1.SV Value component of the symbol MASK, i.e., >FF. In string mode, 
'V1.SV: equals the characters ‘255’. 


V1.SA Attribute component of the symbol MASK. May be accessed by logical 
operators and keywords. 


V1.SL Length component of the symbol MASK. Ifa string has been assigned 
to MASK, then V1.SL is the length of that string. 


Concatenation is especially useful when a previously defined string is augmented 
with additional characters. The string ONE may be represented by a qualified variable 
such as CT.S. In that case, concatenation is expressed as: 


:CT.S:' WAY' 
and provides the same result as writing: 
ONE WAY 


If the qualified variable CT.S represented the string ‘TWO’, then the result of the 
concatenation in the example would be TWO WAY. Strings and qualified variables 
may be concatenated as required and the variable need not be first. Components 
of variables that are represented by a binary value (e.g., CT.V and CT.L) are converted 
to their ASCII decimal equivalents before concatenation. For example, 


Cruse WAY *2Cisis 
is expanded as | 


ONE WAY 3 


since the length component of the variable CT is three. 
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8.6 Operators 


Three types of operators are available for use in the macro assembler: arithmetic, 
relational, and logical operators. 


8.6.1 Arithmetic Operators 


Arithmetic operators, using the functions of +, -, *~ (multiply), and / (divide), generate 
operand values. 


Example of an arithmetic operator: 


LABEL EQU S+4 (current location counter value + 4) 


8.6.2 Relational Operators 


Relational operators compare the values of two variables, or a variable and a constant, 
and return the answer of TRUE or FALSE. The relational operators are as follows: 


= Equal 

> Greater than 
< Less than 

# Not equal 


Examples of relational operators: 


SIF A.V>3 Process succeeding block if value component of variable 
A is >3. 
SIF B.L#A.L Process succeeding block if length component of variable 


B is not equal to length component of variable A. 


8.6.3 Logical Operators 


Logical (Boolean) operators perform the desired operation and return either TRUE 
or FALSE. The following are logical operators: 


& AND 
++ OR 
-- NOT 


Example of a logical operator: 


SIF (A.V>3)&(B.L#A.L) Process succeeding block if both expressions in 
parentheses are true. 
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8.7 Keywords 


The attribute component of assembler symbols and macro parameters contains 
information on various attributes of those symbols and parameters. The macro 
assembly language recognizes certain keywords that are used to access that infor- 
mation. A keyword is used with a logical operator and the attribute component to 
test or to set a specific attribute of a symbol or parameter. 


8.7.1 Symbol Attribute Component Keywords 


The keywords listed in Table 8-3 may be used with a logical operator and the symbol 
attribute component (.SA) to test or set the corresponding attribute component in 
the Assembler Symbol Table (AST). 


Table 8-3. Symbol Attribute Component Keywords 
KEYWORD SYMBOL MEANING 
Relocatable 
An operand of an REF directive 


An operand of a DEF directive 


Assigned a component string 


Defined as a macro name 


Not defined 





Note that the use of these attributes in conditional assembly (see $IF) can lead to 
pass conflict errors if the symbol has not been defined before the macro call. 


Examples using symbol attribute component keywords: 


V1.SA&SSTR The result of an AND operation between the attribute component 
of the symbol MASK (assuming V1.S has been defined as MASK) 
and a flag corresponding to keyword $STR. The expression is 
TRUE when the contents of the string component of MASK are 
not null; otherwise, the expression is FALSE. 


V1.SA++SREL The result of an OR operation between the attribute component 
of the symbol MASK and the flag corresponding to keyword $REL. 


8.7.2 Parameter Attribute Component Keywords 


The keywords listed in Table 8-4 may be used with a logical operator and the macro 
symbol attribute component to test or set the corresponding attribute in the MST 
attribute component or attributes of all variables in the MST. 
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Table 8-4. Parameter Attribute Component Keywords 


KEYWORD SYMBOL MEANING 


$PCALL Appears as a macro instruction operand. 














SPOPL An operand list (the value component 
contains the number of operands in the 


list). 





A symbolic memory address (recog- 
nized when the variable is preceded by 
an @ character). 


Examples using parameter attribute component keywords: 


P6.A&SPCALL The result of an AND operation between the attribute component 
of variable P6 and the flag corresponding to keyword $PCALL. 
The expression is TRUE when variable P6 is a parameter supplied 
in a macro call; otherwise, the expression is FALSE. 


RA.A++SPSYM The result of an OR operation between the attribute component 
of variable RA and the flag corresponding to keyword $PSYM. 


8.8 Verb Statements 
The following verbs may be used in macro statements: 


SASG 
SELSE 
SEND 
SENDIF 
SIF 
SMACRO 
SVAR 


Any statement in a macro definition not containing a macro verb in the operation field 
is processed as a model statement. 


The macro verb statements are listed in alphabetical order and described in the 
following pages. The syntax and an example are also given. 


8.8.1 SASG (Value Assignment Verb) 


The $ASG statement assigns values to the components of a variable. Variables that 
are not parameters do not have values for any components until values are assigned 
using SASG statements. Components of variables with previously assigned values 
may be assigned new values with $ASG statements. 


Syntax: S$ASG <expression/string> TO <var> [<comment> ] 


The expression operand may be any valid assembler expression and may contain 
binary-mode variable references and keywords. 
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A string may be one or more characters enclosed in single quotes or the concat- 
enation of such a literal string with the string mode value of a qualified variable. 
The <var> may be either an unqualified or a qualified variable. 


When the operands are both unqualified variables, all components are transferred to 
target variables. When the destination variable is qualified, only the specified 
component receives the corresponding component of the expression or string. An 
exception to this is when a string is assigned to the string component of a variable 
or symbol, the length component of that variable or symbol is set to the number of 
characters in the assigned string. If the attribute component of the destination 
variable is to be changed, only those attributes that can be tested using keywords 
are changed. Other attributes maintained by the macro assembler may or may not 
be changed as appropriate. A qualified variable that specifies the length component 
is illegal as a destination in a SASG statement, and will NOT set the length compo- 
nent. 


The following examples illustrate the use of $ASG. Variables P3, V3, and CT are 
assumed to have been previously declared either as parameters in a SMACRO state- 
ment or as variables in a $VAR statement. 


SASG P3 TO V3 Assigns all the components of variable P3 to variable V3. 


SASG :P3.S:'ES' TO P3.S 
Concatenates string ‘ES’ to the string component of vari- 
able P3, and set the string component to the result. This 
adds 2 to the length component of P3. 


SASG CT.A++SPSYM TO CT.A 
Sets the flag in the attribute component of variable CT to 
indicate the symbolic address attribute. 


The $ASG statement may be used to modify symbol components as shown in the 
following examples. Assume that P3.V = 6 and P3.S = SUB. 


SASG 'TEN' TO G.S_ Assigns ‘TEN’ as the string component of variable G. When 
‘TEN’ is a symbol in the AST, this statement allows the use 
of symbol component qualifiers to modify the components 
of symbol TEN. 


SASG P3.V TO G.SV_ Sets the value component of the symbol in the string 
component of variable G to the value component of variable 
P3. In this case, the value component of TEN is set to six. 


SASG 'A':P3.S:'S' TO G.SS 
Concatenates string ‘A’, the string component of variable 
P3, and string ‘S’, and places the result in the string 
component of the symbol in the string component of vari- 
able G. Also sets the length component of the same symbol. 
Thus, the string component of TEN is ASUBS, and the 
length component is five. 


Keywords in a $ASG statement must be used with a Boolean (logical) operator and 
an attribute component of a variable in the source field. The attribute component 
must come first. When quoted strings are assigned to the string component of some 
variable, that string may later appear in the list of undefined symbols. 
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8.8.2 SELSE (Alternate Else Verb) 


The $ELSE statement begins an alternate block to be processed if the preceding SIF 
expression was false. 


Syntax: SELSE [<comment>] 


Example: See SIF. 


8.8.3 SEND (Macro Definition Termination Verb) 


The $END statement marks the end of the group of statements of the macro definition 
named in the operand. When executed, the SEND statement terminates the proc- 
essing of the macro definition. 


Syntax: SEND  [<MACRO NAME>] [<COMMENT>] 


Example: SEND FIX Terminates the definition of the FIX macro. 


8.8.4 SENDIF (IF Termination Verb) 


The SENDIF statement terminates the conditional processing initiated by an SIF 
statement in a macro definition. 


Syntax: SENDIF [<comment> ] 


Example: See SIF. 


8.8.5 SIF (Conditional If Verb) 


The SIF statement provides conditional processing in a macro definition. The 
condition of the SIF statement determines whether or not a block of statements is 
processed, or which of two blocks of statements is processed. A block may consist 
of zero or more statements. 


An SIF statement is followed by a block of macro language statements terminated 
by an $ELSE statement or an SENDIF statement. When the SELSE statement ts used, 
it is followed by another block of macro statements terminated by an SENDIF state- 
ment. When the expression in the $IF statement has a nonzero value (or is evaluated 
as TRUE), the block of statements following the SIF statement is processed. When 
the expression in the $IF statement has a zero value (or is evaluated as FALSE), the 
block of statements following the SIF statement is skipped. When the SELSE state- 
ment is used and the expression in the $IF statement has a nonzero value, the block 
of statements following the $ELSE statement and terminated by the SENDIF statement 
is skipped. . 


Syntax: SIF <expression> [<comment> ] 


The <expression> may be any expression as defined for the $SASG statement and 
may include qualified variables and keywords. The expression defines the condition 
for the SIF statement. 


Note that the expression is always evaluated in binary mode. Specifically, the rela- 
tional operations (<,>,=,#) operate only on the binary mode values of macro vari- 
ables. Logical operators may be nested. In addition, $IF blocks may be nested up to 
44 levels. 
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SIF 
ELSE 
SENDIF 


IF -- 


SENDIF 


ue 


Example: 


Key Process the statements of BLOCK A when the value component 

BLOCK A of the symbol in the string component of variable KY contains 
a non-zero value. Process the statements of BLOCK B when the 
component contains zero. After processing either block of 

BLOCK B statements, continue processing at the statement following the 
SENDIF statement. 


(T.A &SPCALL) Process the statements of BLOCK A when the attribute 
component of parameter T indicates that parameter T is not 


BLOCK A Supplied in the macro instruction. If parameter T is supplied, do 
not process the statements of BLOCK A. Continue processing 
at the statement following the $SENDIF statements in either case. 

T.L=5 Process the statements of BLOCK A when the length component 
of variable T is equal to 5; otherwise, do not process the state- 

BLOCK A ments of BLOCK A. Continue processing at the statement 


following the SENDIF statement. 


8.8.6 SMACRO (Macro Definition Verb) 


The SMACRO statement must be the first statement of a macro definition. It assigns 
a name to the macro and declares the parameters for the macro. The macro name 
consists of one to six alphanumeric characters, the first of which must be alphabetic. 
Each <parm> is a parameter for the macro. The operand field may contain as many 
parameters as the size of the field allows and must contain all parameters used in the 
macro definition. The comment field may not be used if there are no parameters. 


Syntax: <macro name> SMACRO [<parm-list>] [<comment>] 


where <parm-list> is a sequence of parameters separated by commas. The macro 
definition is used in the expansion of macro calls where that macro name appears 
in the instruction field. 


Syntax for a call: 
<macro name> [<operand-list>] [<comment>] 


where <operand-list> is a sequence of operands, separated by commas. The macro 
name specifies the macro definition to be used. Each operand may be any expression 
or address type recognized by the assembler, or a character string enclosed in quotes. 
Alternatively, a list that is a group of operands enclosed in parentheses and separated 
by commas (when two or more operands are in the list) may be used. A list is 
processed as a set after removal of the outer parentheses during macro expansion. 


Operands (or lists) may be nested in parentheses in the macro call for use within 
macro definitions. For example, if the macro ONE is defined as 


ONE SMACRO P1,P2 
then the statement 
ONE PAR1,PAR2 


results in PAR1 being associated with P1, and PAR2 being associated with P2. 
Similarly, the statement | 
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ONE PAR1, (PAR21,PAR22) 


results in PAR1 being associated with P1, and PAR21,PAR22 being associated with 
P2. 


The macro expander is responsible for replacing the macro call with the appropriate 
source code. Processing of each macro call in a source program causes the macro 
expander to associate the first parameter in the S$MACRO statement with the first 
Operand or operand list on the macro call line and the second parameter with the 
second operand or operand list, etc. Each parameter receiving a value has the 
S$PCALL attribute (see Table 8-4) set in the MST. When the macro definition has 
more parameters specified than the number of operands in the macro call, the S$PCALL 
attribute is not set for the excess parameters. The $PCALL attribute also is not set 
if an operand is null (i.e., the call line has two commas adjacent or an operand list 
has zero operands). Expansion of the macro can be controlled by the number of 
operands by using the $PCALL attribute and SIF statements. 


For example, a macro definition containing 
AMAC SMACRO P1,P2,P3 

when called by 
AMAC AB1,AB2 

sets SPCALL parameters P1 and P2, but not P3. Similarly, 
AMAC XY,,XY3 

causes $PCALL to be set for P1 and P3, but not P2. 


When the macro call has more operands than the number of parameters in the 
SMACRO statement, the excess operands are combined with the operand or list 
corresponding to the last parameter to form a list (or a longer list). In the macro 
statements shown below, the operands of the two macro calls would be assigned 
to the parameters in the same way. 


Macro Call 1: 
ONE EQU 9 
TWO EQU 43 
THREE EQU 86 | 
FIX SMACRO P1,P2 MACRO FIX 
SEND 
FIX ONE , TWO , THREE MACRO CALL 


FIX | ONE, (TWO, THREE) MACRO CALL 
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Macro Call 2: 


MwHmAnMUOAW 


y 


EQU 
EQU | 
DATA 
DATA 

~~ EQU 
EQU 
EQU 
EQU 
EQU 


SEND 


PARM 


ARM SMACRO. 


ang 


ES: 
17 
63 
95 
47 
58 


101 


119 
P1,P2,P3,P4,P5,P6,P7,P8,P9 


A; (By ();O7(D) (Ey (Gp (8,1) )- 


For the above macro call, the parameter assignments for PARM are as follows: 


PIS=A_. 
P1.A = $PCALL 
P1.L = 1 
Pi.V=7 

P3.S =B 

P3.A = $PCALL 
P3.L = 1 

P3.V = 15 
P5.S=C | 
P5.A = $SPCALL 
P5.L = 1 
P5.V = 17 
P7.S=E 

P7.A = SPCALL 
P7.L = 1 

P7.V = 95 


P9.S = (no string) 
P9.A = (all false) 


P9.L =0 
P9.V=0 


P2.S = (no string) 
P2.A = (all false) 


P2.L = 0 

P2.V=0 

P4.S = (no string) 
P4.A = $POPL 

P4.L =0 

P4.V=0 

P6.S =D 

P6.A = $PCALL,SPOPL 
P6.L = 1 

P6.V = 1 

P8.S = G,(H,l) 

P8.A = $PCALL,SPOPL 
P8.L=7 

P8.V =2 


A macro definition supercedes previous macro definitions and native instructions | 
with the same name. Symbolic operands that appear in a macro call are treated as 
symbolic operands in native instructions; i.e., if they are not defined with the program 
in which they appear, they are listed as undefined symbols. 
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8.8.7 $VAR (Variable Declaration Verb) 


The $VAR statement declares the variables for a macro definition. The $VAR state- 
ment is required only if the macro definition contains one or more variables other than 
parameters. More than one $VAR statement may be included, and each $VAR 
statement may declare more than one variable. Each <var> in the operand its a 
variable. 


Syntax: SVAR <var>[,<var>] [<comment>] 
Example: SVAR A,CT,V3 THREE VARIABLES FOR A MACRO 


The example declares variables A, CT, and V3, which must not have been declared 
as parameters. 


The SVAR statement does not assign values to any components of the variables; that 
is the function of the $ASG statement. SVAR statements may appear anywhere in 
the macro definition to which they apply, provided each variable is declared before 
the first statement that uses the variable. Placing $VAR statements immediately 
following the $MACRO statement is recommended for clarity in reading the source 
code. 


8.9 Model Statements 


A macro definition consists of model statements and statements that contain macro 
verbs. Processing a model statement results in an assembly language statement. 
This statement may be composed of the usual elements of an assembly language 
statement combined with string mode qualified variable components. 


Examples of model statements: 


IN *+,PA7,1 An assembly language source statement that contains a 
machine instruction. 


:P7.S: LAR :P2.S:,R8 :V4.S: 

The string component of variable P7, followed by one blank, 
LAR, and one more blank, is concatenated to the string. The 
string component of variable P2 is concatenated to the 
result, to which R8 and three blanks are concatenated. A 
final concatenation places the string component of variable 
V4 in the model statement. The result is an assembly 
language machine instruction having the label and 
comment fields and part of the operand field supplied as 
string components. 


>MS.S: The string component of variable MS. Preceding statements 
in the macro definition must place a valid assembly 
language source statement in the string component to 
prevent assembly errors. 


Note that conditional assembly directives may not appear as operations in a model 
statement. Comments supplied in model statements may not contain periods since 
the macro assembler scans them. Improper use of punctuation may cause syntax 
errors. 
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8.10 Macro Examples 


Macros may simply substitute a machine instruction for a macro instruction, or they 
may include conditional processing, access the Assembler Symbol Table (AST), and — 
employ recursion. Several examples of macro definitions are described in the 
following paragraphs. | 


8.10.1 ID (identification Macro) 


The ID macro, an example of a macro with a default value, supplies two DATA 


directives to the source program. The ID macro consists of nine other macro state- 


ments, four of which are model statements. The definition is as follows: 


ID ~~ $MACRO 


DATA 


SIF 


DATA 


SELSE 


DATA 


START EQU 


SENDIF 


SEND 


WS,PC 


:WS.S: 


PC. A&SPCALL 


ePC.52-;,15 


START,15 


Defines 1D with parameters WS and PC. 


Model statement: places a DATA directive with 
the string of the first parameter as the operand 
in the source program. 


Tests for presence of parameter PC. 


Model statement: places a DATA directive in 
the source program. The first operand is the 
string of the second parameter, and the second 
operand is 15. This statement is processed if 
the second parameter is present. 


Starts the alternate portion of the definition. 


Model statement: places a DATA directive in 
the source program. The first operand is label 
START, and the second operand is 15. This 
statement is processed if the second parameter 
is omitted. 


Model statement: places label START in the 
source program. This statement is processed 
if the second parameter is omitted. 


Ends the conditional processing. 


Ends the macro. 


Syntax: [<label>] ID <exp>[,<exp>] [<comment>] 


The addresses may be expressions or symbols. 


Example of a macro call for macro ID: 


ID 


The resulting source code would be 


DATA 
DATA 


WORK1,BEGIN 


WORK1 
BEGIN, 15 
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If only one operand is supplied, the macro instruction could be coded as follows: 
ID WORK2 


This would result in the following source code: 


DATA WORK2 
DATA START,15 
START EQU $ 


This form of the macro instruction imposes two restrictions on the source program. 
The source program may only call the ID macro with a single parameter once. This 
is necessary to prevent the use of the label ‘START’ more than once. Problems with 
labels supplied in macros may be prevented by reserving certain characters for use 
in macro-generated labels. A macro definition may maintain a count of the number 
of times it is called, and use this count in each label generated by the macro. 


8.10.2 GENCMT (Generate Comment Macro) 


The GENCMT macro implements only those comments that appear in the macro 
definition and the expansion of the macro. In the following example, the first five lines 
define the macro, followed by :V.S: that expands the macro definition. 


Example of assembler list file: 


0001 IDT "GENCMT'! 
0002 GENCMT SMACRO 
0003 SVAR V 
0004 * THIS IS A MACRO DEFINITION COMMENT. 
0005 SASG:. T*? TO V.5 
0006 :V.S: THIS IS A MACRO EXPANSION COMMENT. 
0007 SEND 
0008 e 
0009 * 
0010 GENCMT 
0001 * THIS IS A MACRO EXPANSION COMMENT. 
0011 0000 OO000 DATA 0,1 
QO001 OOOL 
0012 GENCMT 
OOO1 * THIS IS A MACRO EXPANSION COMMENT. 
0013 GENCMT 
0001 * THIS IS A MACRO EXPANSION COMMENT. 
0014 Q0002 0004 DATA 4 
OOQ15 END 


NO ERRORS, NO WARNINGS 


Assembler Macros 


8.10.3 FACT (Factorial Macro) 


The FACT macro, an example of the recursive use of macros, produces the assembly 
code necessary to calculate the factorial of N where N is an immediate value, and 
store that value at data memory address LOC. FACT accomplishes this by calling | 


FACT1, which calls itself recursively. 


Example: 
FACT 
* 


* 
* 


FACTIL 


SMACRO N,LOC 


SIF N.V<2 
LACK 1 
SACL :LOC: 
SELSE 
LACK :N.V: 
SACL :LOC: 


SASG N.V-1 TO N.V 
FACT] :N.V:,:LOC: 
SENDIF 


SEND 

SMACRO M,AREA 
SIF M.V>l 

LT :AREA: 
MPYK :M.V: 
PAC 

SACL :AREA: 


SASG M.V-1 TO M.V 


FACTI :M.V:,:AREA: 


* 


* 


N IS AN INTEGER CONSTANT AND 
LOC IS THE DATA MEMORY ADDRESS 
WHERE N! IS TO BE STORED. 


N >= 2 SO, STORE N AT LOC, 
DECREMENT N, AND DO THE 
FACTORIAL OF N-l. 


MULTIPLY PRESENT FACTORIAL 
BY PRESENT POSITION. 


SAVE RESULT. 
DECREMENT POSITION. 
RECURSIVE CALL. 


SENDIF 
SEND 


8.11 Macro Error Messages 


Table 8-5 lists and defines the macro error messages, and gives correction informa- 
tion. 


Table 8-5. Macro Error Messages 


[____wessace DESCRIPTION 


MACRO LINE TOO LONG In a macro definition, macro directive lines may be only 58 characters long. 
Model statements, when fully expanded, may be only 60 characters long. 


LONG MACRO VARIABLE QUALIFIER Macro variable qualifiers may be only one or two characters long. 


TOO MANY MACRO VARIABLES The total number of macro parameter variables and labels in a single macro 
definition may not exceed 128. 


INVALID MACRO QUALIFIER The only valid macro qualifiers are: S, V, L, A, SS, SV, SL, and SA. 


VARIABLE ALREADY DEFINED A macro variable cannot be redefined within a macro. 
IF LEVEL EXCEEDED The maximum nesting level of SIF directives is 44. 


The macro assembler has detected an internal error. These can be caused 
by incorrect syntax. 





MACRO ASSEMBLER PROGRAM ERROR 
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9. Link Editor 


The Link Editor combines separately generated object modules with associated 
procedures and overlays to form a single, linked, relocatable object module that can 
be installed and executed on various computer systems. The object code is generated 
by an assembler supplied with the TMS320C25 software development system. The 
link editor is currently available for the VAX (VMS) and TI/IBM PC (MS/PC-DOS) 
Operating systems. 


This section describes the Link Editor, its files and control commands, and gives 
examples of various linking procedures. Included in this section are the following 
major topics: 


@ Description (Section 9.1 on 9-2) 


@ Program definition (Section 9.2 on 9-2) 
Phase and task 


@ Link Editor Files (Section 9.3 on 9-2) 
Link control file 
Object modules 
Libraries 
Linked output file 
Listing file 


@ Linker Commands (Section 9.4 on 9-5) 
Entering a command 
Command set summary (listed according to function) 
Individual command descriptions (alphabetized) 


@ Linking Examples (Section 9.5 on 9-36) 
Simple link 
RAM/ROM partitioning 
Partial link 
Library creation 


@ Link Editor Error Messages (Section 9.6 on 9-49) 
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9.1 Description 


The Link Editor provides symbol resolution for external references and definitions 
created by the REF and DEF assembler directives (see Section 6). Without this 
function, all modules would have to be compiled or seer at once, and modules 
written in different languages could not be mixed. 


The Link Editor builds a list of symbols from the REF tags in the object modules that 
are included in the linking process. The Link Editor then resolves references by 
matching DEF tag symbols with the REF tags and inserting the correct values for 
these symbols in the linked object code. 


The Link Editor can position the three defined segments (program, data, and 
common) to prescribed boundaries for eventual ROM/RAM partitioning. Program, 
data and common segments are defined by the PSEG, DSEG, and CSEG assembler 
directives, respectively. If these directives are not used, the entire object module is 
tagged as a program segment. 


When PSEG, DSEG, and CSEG tags are encountered in the included modules, the 
Link Editor reorganizes segments from each module into three segments in the linked 
output. The first segment contains the PSEGs of all included modules, the second 
segment contains the DSEGs, and the third segment the CSEGs of all included 
modules. The beginning location for each segment can be user-defined. 


The Link Editor also allows overlays and procedure/task segmentation. However, if 
the system being used loads only one module at a time, procedure/task segmentation 
and overlays cannot be used because they produce multiple output modules. 


9.2 Program Definition 


To use the Link Editor, each program must be defined as a phase or a task. Below 
are the definitions of each. 


Phase The smallest functional unit that can be loaded as a logical entity during 
: execution in an overlay structure. 


Each phase is identified by a name and a level number. The root phase 
is at level O and is that portion of the program that must remain memory 
resident. Other phases (level 1 and above) that do not have to be 
simultaneously memory-resident can overlay each other. 


Task A complete program containing both variable data and executable code 
or the variable data portion of a program (for procedure/task segmen- 
tation). 


9.3 Link Editor Files 
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Executing the Link Editor utility begins by accessing the Linker and then responding 
to prompts for the link control file, linked output file, and listing file. The Link Editor 
utility uses the following five files in the linking process: 


Link control file 
Object modules 
Libraries 

Linked output file 
Listing file. 


Link Editor 


Each file is given a pathname so that when that pathname is entered, the Link Editor 
can search for that file. The pathnames for the link control file, object modules, 
declared libraries, the linked output file, and the listing file are in the listing file. An 
example of pathname structure (default value) for the link control file is given for the 
two operating systems currently available for the TMS320C25 Link Editor. 


Pathname System 
[PROJECT.MACK]SEGMENT.CON VAX (VMS) 
A:PARTIAL.CTL TI/IBM PC (MS/PC-DOS) 


Each of the link editor files is described in the succeeding subsections. 


9.3.1 Link Control File 


The link control file is an input file that controls the operation of the Link Editor. 
This file contains a set of link control commands called a control stream which 
defines the modules to be linked and how they are to be linked. The Link Editor links 
the object modules in the order specified by the linker commands. See Table 9-2 
for a summary of all the linker commands. 


The link control file must be created ahead of time. Entering a pathname instructs the 
editor to look for a file containing the necessary control commands. 


9.3.2 Object Modules 


Object modules are the input programs that are to be linked together. They are 
contained in files and must consist of either ASCII or compressed 990-tagged object 
code. The ASCII 990-tagged object code is the type of code generated by the 
assembler supplied with the TMS320C25 Software Development System. The object 
code consists of ASCII tags followed by data fields (see Section 7.9 for a description 
of object code format). 


As the Link Editor finishes writing out an object module, it names the module and 
gives the number of object records it contains. When the link terminates normally, 
the last line written reads '*** LINKING COMPLETED'. The date and time at the 
end of the link are printed on the last line. The date and time captured at the 
beginning of the link are printed at the top of every page and on the last card of every 
module in the linked object. 


Object modules can be explicitly user-defined with the INCLUDE command in the 
control file, or automatically included by the Link Editor as a result of a search for 
unresolved references. 
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9.3.3 Libraries 


Libraries are directories or files containing collections of object modules. An object 
library may be either random or sequential. A random library is a directory of object: 
modules in separate files, whereas a sequential library is a file containing one or more 
object modules concertina together. See Section 8.5.4 for examples of library 
creation. 


Libraries are used to automatically resolve the REF and DEF tag symbols between 
object modules specified in INCLUDE commands. 


Two types of symbol resolution are implemented: 


@ Automatic symbol resolution by default (the AUTO command) when the END 
command is detected in the control file unless the NOAUTO command has been 
used. 


@ Symbol resolution at a user-defined point in the linking process when a 
SEARCH or FIND command is used. The SEARCH command is used with 
random libraries and the FIND command with sequential libraries. 


Libraries defined by the LIBRARY command are searched in the same order they are 
defined. Any additional unresolved references created by modules to satisfy refer- 
ences are also resolved automatically. Automatic symbol resolution still occurs at 
the end of the linking process for any remaining unresolved references unless a 
NOAUTO command is in the control file. 


9.3.4 Linked Output File 


9.3.5 Listing 
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The linked output file is an 80-character output file containing the 990-tagged object 
format load module in the “LINKED OUTPUT” file. This load module appears in 
ASCII or compressed format, depending on the use of the FORMAT command in the 
object link control file. The response to the linked output file name specifies the 
destination of the load module. . 


File 


The listing file consists of a listing that includes the control] stream and a link map 
that lists the modules with their origins and lengths. The ‘link map consists of the 
following four sections: | | 


1) Individual constituent object modules 

2) Common segments 

3) Symbols (external) 

4) Unresolved references (identified even if the NOMAP option has been selected). 


The response to the listing file access name specifies the destination of the listing 
generated during the link edit. The pathnames for the control file, the listing file, the 
linked object file, and declared libraries are in the listing file. Messages are listed for 
detected errors in the listing file.. 


The Link Editor creates two temporary files on the work file disk. Therefore, sufficient 
space for two disk or diskette files must be available. 
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9.4 Linker Commands 


Link control commands define the modules to be linked and how they are linked. 
This section gives some rules for entering a command in the link control file. 


A command set summary of all the linker commands, arranged according to function, 
is provided for easy reference. Each command in the summary table is next described 
individually. Linker syntax and example(s) are also given for each command. The 
commands are listed in alphabetical order. 


9.4.1 Entering a Command 
When entering a command in the control file, these rules should be followed: 


® Either the entire command or only the first four characters may be specified. 

@ At least one space must separate the command from its parameters. 

@ Comments may be entered either on a separate line or following the command 
parameters. 

@ All comments must be preceded by a semicolon (;). 

@ The command must be contained within the first 72 characters of the line. 


9.4.2 Linker Command Set 


Table 9-1 lists the symbols used in the syntax definitions of the linker commands. 


Table 9-1. Linker Syntax Symbols 


[SYMBOL] MEANING 


User-defined parameters. 
Optional parameters. They may be omitted. 
Alternative parameters, one of which must be entered. 
The preceding parameter may be repeated. 
Indicates “contents of”. 

<acnm> | An access name for a file or library must be entered for 
the parameter. 

<base> The starting location of a segment, expressed as either 
a decimal or hexadecimal number up to five digits in 
length. 

<level> | The level of a phase. 

<name> | The name of a specified area. Consists of one to eight 
alphanumeric characters, the first of which must be 
alphabetic. 

(<name>) | The name of a member in a library. 

<value> | The number of lines, between 16 and 60, to be printed 

on a page. Replaces the default value of 60. 
> Represents hexadecimal, as does also a leading zero. 


Words shown in capital letters and special characters 
not listed here must be entered as shown. 





The link command set summary of Table 9-2 is arranged according to function and 
alphabetized within each functional grouping. Of the four groups, the first group 
consists of basic commands that are required to perform basic Link Editor functions. 
The second group consists of ROM/RAM partitioning commands. The third group 
includes those miscellaneous commands that perform auxiliary link editor functions, 
such as specifying default conditions and procedure/task segmentation. The fourth 
group consists of the partial link commands. 
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Table 9-2. Linker Command Set Summary 


ta : : oe 


| fe BASIC COMMANDS. —s_ a: 
[Command | Function 
Indicates the end of the control stream. This is a required command. os 


Specifies a search of only sequential libraries for unresolved references at this point 
in the control stream. : 


Defines the format of the linked output module as ASCII or COMPRESSED code. 
The default is ASCII object code. 


INCLUDE Defines one or more modules to be included in the linking process. At least one 
INCLUDE command is required in each control stream. 
LIBRARY Defines a random library directory. 


PHASE Defines the level and name of a phase in a program. Either the PHASE or the TASK 
3 command must appear in each control stream. Multiple phases are allowed when. 
overlays are used. 


SEARCH Specifies a search of defined random libraries for unresolved references at this point 
in the control stream. 

TASK Defines a phase to be installed and executed as a task or standalone program. A | 
name is assigned the task. | 


a ROM/RAM PARTITIONING COMMANDS 







FIND 


FORMA 









Controls the relative positioning of the program, data, and common segments 


~ Command 
ALLOCATE 





(PSEG, DSEG, and CSEG assembler directives, respectively). 

Specifies the starting location of the common segment in the linked output. 
Specifies the starting location of the data segment in the linked output. 
Specifies the starting location of the program segment in the linked output. | 


COMMON. 
DATA 
PROGRAM 


AUXILIARY FUNCTION COMMANDS 


Command [| C‘“‘(‘ ‘Function 
_| ADJUST Aligns a phase or a module within a phase on a specified boundary. 


AUTO Specifies automatic symbol resolution at the end of the control stream (default 
condition). 


Suppresses generation of the linked output file. Useful for error identification or 





DUMMY 





when only a listing file is required. 


ENTRY Specifies a symbol for an entry tag to be produced. 


NOAUTO Inhibits automatic symbol resolution, allowing the user to explicitly control library 
searching for unresolved references. | 


- Suppresses the output of the link map listing by omitting the module, common, and 
-symbol maps from the listing. 


NOPAGE Inhibits page ejects between the link maps of each phase. 


NOSYMT. _| Omits symbol tables from included modules in the linked output file (default 
condition). 


PAGE — Causes page ejects between link maps for each phase (default condition). 


PROCEDURE ~ Defines a phase of the link edit structure which can be installed as a procedure. 
Used for procedure/task segmentation only. An alternate version of this command 


NOMAP 








can be used to support levels 1 and 2. 


REPLACE Replaces one external symbol name for another in the next object file read in. 
SYMT Includes symbol tables in linked output files. | 


PARTIAL LINK COMMANDS 


Command | Function 


Declares all external definitions in included modules as global symbols for subse- 





ALLGLOBAL 





quent relinking (default condition). 


GLOBAL | Identifies the symbols defined in included modules to be processed as global 
symbols for subsequent relinking. 

NOTGLOBAL Declares either specified externally defined symbols or all externally defined symbols 
in included modules as local symbols. 


PARTIAL Performs a partial link and outputs either ASCII or compressed object code. The 
i output of a partial link must be linked again without the PARTIAL command before 
the program can be loaded and executed. : 
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9.4.3 Individual Command Descriptions 


Each command in the linker command set summary is described in the following 
pages. Information, such as linker syntax, a description, and example(s), is given for 
each command. The commands are listed in alphabetical order. 
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Description 
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ADJUST [<n>] 


where <n> = a decimal ace less than 16 epesitvine: a power- of- 
| | | two bytes. A value greater than 15 causes an error. 
When the parameter is omitted or equal to zero, align- 

-ment is on the next word boundary. 


The ADJUST command specifies the alignment of a phase or of a viodule within 
a phase on a specified boundary. 


When the ADJUST command appears immediately before a PHASE command, 
the next phase and all subsequent phases of the same level and with the same 
parent node are aligned on the specified boundary, relative to the beginning of 
the program. 


lf the ADJUST command follows a PHASE command but precedes all INCLUDE 
commands in the phase, the effect is the same as above. When the ADJUST 
command follows a PHASE command but precedes an INCLUDE command, the 
next module in that phase is aligned on the specified boundary, relative to the 
beginning of the phase. 


ALLG Declare Global Symbols Command _ ALLG 


Syntax ALLGLOBAL 


Description The ALLGLOBAL (partial linking) command declares all external definitions in 
included modules as global symbols. ALLGLOBAL is a default condition. 


Global symbols are externally defined in the linked output module and therefore 
may be re-linked in a subsequent linking process. 
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Syntax 


Description | 


ALLOCATE 


The ALLOCATE command controls the relative positioning of program, data, and 


‘common segments (PSEG, DSEG, and CSEG directives, respectively). ALLO- 
CATE has no parameters. | 


ALLOCATE directs the Link Editor to reserve space of all outstanding data and 
common segments as if no more object modules were to be included in the link. 
The primary purpose of the ALLOCATE command is to aid the user in sharing 
non-reentrant procedures between different tasks. 


The ALLOCATE command only works if all read/write data is contained in data 
segments (DSEGs) or common segments (CSEGs). 





AUTO Automatic Symbol Resolution Command AUTO 


Syntax AUTO 


Description The AUTO command specifies automatic symbol resolution using defined libraries 
at the end of the linking process. The AUTO command has no parameters and 
is optional. It is the default condition. 





Description 


Example 1 


Example 2 


Example 3 


Example 4 


COMMON {<base>[,<name>] [,<name>]...} 


where <base> = the starting location of the common segment. It can 
a _ be expressed as either a decimal or hexadecimal number | 
up to five digits in length. 


<name> = the name of the common segment. Any unnamed 
: common segment begins after the last data area 
encountered. The commons are allocated in the order 

in which the definitions appear in the object module. 


The COMMON command defines the starting address for the specified common 
segment (CSEG). Commons that are loaded at the specified address must be 
specifically identified within this command. The COMMON command is only valid 
when used with the PROGRAM command and is ignored if used alone. 


More than one COMMON command may be used, and a continuation can be 
performed by repeating the command using a previously named common instead 
of a starting address. The COMMON command cannot be used in partial links. 


COMMON 01000,COMA Begin common COMA at location 
>1000. 
COMM >1000,COMA Results are the same as the 


preceding example. 


COMMON COMA , COMB Begin common COMB immediately 
following COMA. 


COMM 4096 ,COMA, COMB Results are the same as the 
| two preceding examples. 





DATA Set Starting Location Counter for DSEG Command DATA 


Syntax 


Description 


Example 1 


Example 2 


DATA <base> 


where <base> = the starting location of the data segment. It can be 
expressed as either a decimal or hexadecimal number 
up to five digits in length. 


The DATA command defines the absolute starting address for the data segment 
(DSEG) in the linked output. The DATA command is only valid when used with 
the PROGRAM command and is ignored if used alone. 


The DATA command may appear more than once in the control stream, but the 
first DATA command must appear before the first INCLUDE command. If the 
DATA command is omitted, the starting location for each data area defaults to the 
end of the corresponding program area. 


The DATA command cannot be used in partial links. 
DATA 01000 Begin data segment at location >1000. 


DATA 4096 Same as the preceding example. 





Syntax 


Description 


DUMMY 


The DUMMY. command supresses generation of the linked output file. This 


command is useful for error identification or when only a listing file is needed. 
DUMMY has no parameters. | 





END Specify End of Control Stream Command END 


Syntax END 


Description The END command specifies the end of the control stream. The command is 
required in every control stream. 





Syntax ENTRY <symbol> 


Description | ~The ENTRY command specifies a symbol for the entry point in order to produce 
an entry tag. This overrides all entry tags received in input object modules. 





FIND 


Syntax 


Description 


Example 


search Sequential Libraries | 
for Unresolved References Command | FIND 


FIND <acnm>[,<acnm>][,<acnm>]... 


where <acnm> = the access name of the sequential library that is to be 
searched for unresolved references. 


The FIND command specifies a search of sequential libraries for members 
representing unresolved references. Only one pass is made through a library in 
response to a single FIND command. The search occurs at the point in the linking 
process where the FIND command occurs. 


The FIND command functions as a SEARCH command but applies to sequential 
libraries only. The FIND command is listed as a SEARCH command in the link 
map. 


FIND A:*.EXT For PC/MS-DOS system. 
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Syntax 


Description 


FORMAT {ASCII,COMPRESSED} 
The FORMAT command defines the format. of the linked output module. 


The format specified may be either ASCII or COMPRESSED object code. In ASCII 
format, each integer value in the object is represented as a four- byte character 
string. ASCII format is also called 990-tagged object format and is the default 
condition. Compressed format is more efficient to use since each integer value 
is represented as a two-byte word. 





GLOB Identify Global Symbols Command __ GLOB 


Syntax 


Description 


GLOBAL [symbolname] [,symbolname]... 


where symbolname = a symbol that is to be processed as a global symbol. It 
is defined at assembly time and consists of six charac- 
ters or less, the first of which must be alphabetic. 


The GLOBAL command is a partial linking command, identifying the symbols 
defined in included modules to be processed as global symbols. Global symbols 
are externally defined in the output module that may be relinked. 


Each parameter specifies a symbol that is to be processed as a global symbol. 
The command may include several parameters and may appear more than once 
in the command stream. If no parameters are specified, the command functions 
as an ALLGLOBAL command. 


Symbols defined by the GLOBAL command are not affected by the NOTGLOBAL 
command (no parameters) that declares all symbols to be local. 


INCL Specify Modules To Be Included in Link Command INCL 


Syntax 


Description 


Example 1 


Example 2 


Example 3 
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INCLUDE 


INCLUDE {<acnm>[,<acnm>]...,(<name>) [,(<name>)]...} 


where <acnm> = - the access name of a file containing the object 
module(s) to be included in the linking process. 


(<name>) = a member in a library. 


The INCLUDE command specifies modules to be included in the linking process. 
This command is required in the control stream. More than one INCLUDE 
command may be used as needed. 


A PROCEDURE, TASK, or PHASE command must precede the first INCLUDE 
command. 


If the <name> parameter is used, enclose only the file name or module name of 
the object modules (rather than the entire access name) in parentheses. The 
specified <name> must be of a file contained in a defined random library. The 
Link Editor searches the defined libraries for the specified module. 


If no parameters are given, in-line text format (not compressed) object code is 
assumed. The in-line object (see Example 3) is delimited by either end-of-file 
or by a record with ‘'/*’ in columns one and two. This method is suitable, for 
example, when the control file is read in from a card reader (in which case, 
end-of-file is denoted by a ‘/*’ card). 


INCLUDE (X) Search defined random libraries for 
a file named X and include the 
module(s) in that file. 


INCLUDE TEST .MPO Include the module TEST.MPO from the 
default directory on a PC/MS-DOS 
system. 


KOO6CCARTMONDS50020LBL2B150021LBL2B240000LBL2C240000LBL2D2A00207F1E7F 
BCE26BCE26BFE80EQOQOQOOQOQOQO00BFE80E0O0010000BCE1BBO0201B0388B4802B48A97F1E1F 
BFFEEBCE2 7BCE50BCEO4BCEO05BCE01B567BB568CBCEOOBCEOFBCE1FB807AB81A87F048F 


VE 


CARTMOND Q/10785. 1O0s53214 ASM32020 PC 1.0 85.092 


LIBR Define Random Library Directories Command, LIBR 


Syntax LIBRARY <acnm>[,<acnm>]... 
where <acnm> = the access name of the directory that is to be defined 
as a library. 
Description The LIBRARY command defines random library directories. Random libraries 


must consist of a directory, and the files in the directory must contain 990-tagged 
object modules. Sequential libraries, consisting of a sequential file of object 
modules, are indicated using the FIND command. 


Example LIBR At* EXT Define drive A: as a random 
library of files with extension 
-EXT on a PC/MS-DOS system. 
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NOAU _ Inhibit Automatic Symbol Resolution Command NOAU 


Syntax 


Description 
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NOAUTO 


The NOAUTO command inhibits automatic symbol resolution at the end of the 


linking process. This command allows the user to explicitly control library 
searching for unresolved references through use of the SEARCH and FIND 


commands. NOAUTO has no parameters. 





Omit Module, Common, and Symbol Maps | 


NOMA from Listing Command NOMA 


Syntax NOMAP 


Description The NOMAP command specifies that the module, common, and symbol maps 
are to be omitted from the listing. This gives some improvement in terms of speed 
and number of symbols that can be processed. The following information is still 
printed on the listing file: 


@ Length of task and procedure(s) 
@ Unresolved references 
@ Release number of the Link Editor. 


NOMAP must appear before any PHASE or TASK commands are used. 
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NOPA —_ Set No Page Ejects Between Link Maps Command NOPA 


Syntax NOPAGE 


Description The NOPAGE command sets no page ejects between the link maps for each phase. 
New pages are started for the listing of the first phase and when the number of 
lines per page has been exceeded. 
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NOSY | Omit Symbol Table from Modules Command NOSY 


Syntax NOSYMT 

Description The NOSYMT command omits symbol tables from included modules in the linked 
output file. This provides for more compact object code but does not allow 
symbolic debugging. 
The NOSYMT command may appear anywhere in the control file. However, if 
an overlay structure is used, the NOSYMT command must appear in the root phase 
(phase 0). 


NOSYMT is the default option and is the inverse of SYMT. 
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Description 
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NOTGLOBAL [symbolname] [,symbolname]... 


where symbolname = a symbol which is to be processed as a local symbol. 
| It is defined at assembly time and consists of six char- 
acters or less, the first of which must be alphabetic. 


The NOTGLOBAL command is a partial linking command, declaring that either 


specified externally defined symbols or all externally defined symbols in the 


included modules are to be processed as local (not global) symbols. 


Local symbols are not externally defined in the partially linked output module and 
thus can only be referenced by modules included in the current partial link. 


The command may include several parameters and may appear more than once 


in the command stream. If no parameters are specified, all symbols are processed 


as local, except those specified in the GLOBAL command. 


PAGE Set Page Eject to Separate Link Maps Command PAGE 


Syntax PAGE [value] 
where value = the number of lines to be printed on a page, replacing 
the default value of 60. The value parameter is optional, 
but when present, the value must be between 16 and 
60. 
Description The PAGE command causes page ejects to separate the beginning of each link 


map for each phase. This is the default condition. 
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PART 


Syntax 


Description | 
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Perform Partial Link Command ——__._- PART 


PARTIAL 


The PARTIAL command performs a partial link and outputs either ASCII or 
compressed object code. The output of a partial link is not executable and must 
be linked again without the PARTIAL directive before the program can be loaded 
and executed. : .* 


The PARTIAL command causes the Link Editor to do the following: 


1) Resolve all external references defined by any module included in the partial 
link. 


2) Retain all entry points in the partial link as an entry in the output (subject 
to GLOBAL, NOTGLOBAL, ALLGLOBAL commands). | 


3) Retain the common tags and update common numbers. 
4)  Qutput one data section that is the total of all input data sections. 


Partial linking is allowed for single phases only, and the control stream must 
contain either a TASK or PHASE 0 command. If partial linking of overlays is 
required, each phase must be partially linked separately as a phase 0. The phase 
level and name may be redefined in subsequent links. The following commands 
are invalid with partial links: ALLOCATE, PROGRAM, DATA, COMMON, and 
DUMMY. 





PHAS 


Syntax 


Description 


Example 1 


Example 2 


Define Phase Level and Name Command PHAS 


PHASE <level>,<name> 


where <level> = 


<name> = 


the level of the phase. Levels specified greater than zero 
can be used for overlay structures only. Level O defines 
the root (memory-resident) phase. Each subsequent 
PHASE command defines the level and name of an 
overlay. 


the name of the phase. It consists of one to eight 
alphanumeric characters, the first of which must be 
alphabetic. The name supplied becomes the IDT name, 
placed on the last card of the object module produced 
and on the identification fields of ASCll-formatted 
object records. 


The PHASE command defines the level and name of a phase in a program. 


PHASE 0 and TASK commands are logically identical; one and only one of these - 
two commands must appear in each control stream. 


The Link Editor produces an output module for each phase of the program. PHASE 


commands are followed by INCLUDE commands that define the modules included 
in the phase. Multiple phases are allowed when overlays are used. 


PHASE O,MAIN 


PHAS 2,DISK 


Define phase MAIN at level 0. 


Define phase DISK at level 2. 
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Description 


Example 1 
Example 2 


Example 3 
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PROCEDURE {<name>,<level,name>} 


~ where <name> = the identifier of the procedure to be used. The parameter 


consists of one to eight alphanumeric characters, the 
_ first of which must be alphabetic. 


<level> = the level of the phase. 


The PROCEDURE command provides procedure/task segmentation by defining 
a phase of the link edit structure, which can be installed as a procedure (a 
re-entrant procedure may be shared among several tasks). The name supplied 
becomes the IDT name, placed on the last record of the object module produced 
and on the identification field of ASClIl-formatted object records. This command 
is useful in ROM/RAM partitioning for generating load modules with a level of 


root phase 0. 


When used, the PROCEDURE command must precede the TASK command, all 
PHASE commands, and.the INCLUDE command that defines the procedure 
module. . 


The PROCEDURE command is used with the INCLUDE commmand to define the 
procedure. The PROCEDURE command defines the name of the procedure, and 
the INCLUDE command defines the modules that are to be in that procedure. 
Procedures contain the program segment (PSEG), which may be the entire 
program but is usually only the executable code and read-only data. 


A generalization of the standard PROCEDURE command is supported for levels 
1 and 2. In place of a single first procedure, any number of other level-one 
procedures can be defined, any of which can be resident in memory at a given 
time under the user’s control. The length of the first procedure area is the maxi- 
mum of the lengths of the individual level-one modules. Analogous properties 
apply to second-level PROCEDURES. Modules brought in by automatic call to 
satisfy references in any procedure module are placed in the root. 


PROCEDURE FORLIB Define procedure FORLIB. 
PROC RUNLIB Define procedure RUNLIB. 
PROCEDURE 2,FILEMG Define a procedure FILMG at level 2. 





PROG Define Absolute Starting Counter for PSEG Command PROG 


Syntax PROGRAM <base> 
where <base> = the starting location of the program segment. It can 
be expressed as a decimal or hexadecimal number up 
to five digits in length. 
Description The PROGRAM command defines the absolute starting address for the program 


segment (PSEG) in the linked output. 


The PROGRAM command may be used more than once. The first PROGRAM 
command must appear before the first INCLUDE command. Use of the PROGRAM 
command by itself or with the DATA and COMMON commands causes the linked 
output to be loaded at the specified address (base). 


Example 1 PROGRAM O1F00 Begin program segment at location 
>1FOO. 

Example 2 PROG >1F00 Same as the preceding example. 

Example 3 PROG 7936 Begin program segment at location 


7936 (>1F00). 
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Description 
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REPLACE <oldsym(newsym) > [,<oldsym(newsym) >]... 


where oldsym = —____‘' the currently existing external symbol representing a 


reference, definition, or common name. 


(newsym) = the new external symbol to replace the oldsym. 


The REPLACE command specifies that in the next file read in, each occurrence 
of ‘oldsym’ as an external symbol is replaced by ‘newsym’. The command applies 
to every module in a file containing multiple modules. It applies only to the first 
file in an INCLUDE command list. If the command immediately precedes a FIND, 
SEARCH, or END command, it still applies to the next single file read in. 


If ‘oldsym’ is SDATA and an affected module contains a DSEG, the link editor 
converts the DSEG to a common with the name ‘newsym’. This means that no 
data segment is identified in the listing, and if other instances of the common name 
occur, the common may be extended in length or promoted (moved up to a 
lower-numbered phase). 


Note that data segments can be shared by using the REPLACE command to 
convert them to a common. Appropriately used, this permits a module to share a 
data segment in an ancestor phase and places no restrictions on the order of 
definition of segments with different lengths. 





SEAR Search for Unresolved References Command |. SEAR 


Syntax SEARCH [<acnm>][,<acnm>]... 


where <acnm> = the access name of random libraries to be searched. 
The order of these access names determines the order 
of the search. If no <acnm>s are specified, the libraries 
defined by the LIBRARY commands define the search 
ordering. 


Description The SEARCH command directs the Link Editor to search for unresolved references 
at any point in the control stream. 


If a SEARCH command is given in a phase other than the TASK or PHASE O phase, 
searching is performed only for symbols that are unresolved in that phase. Unre- 
solved references that were established in or promoted to other phases are ignored. 


A SEARCH command in a TASK phase causes searching to be done for every 
phase (for the given phase and all its descendant and previous phases). The only 
way the SEARCH command can be applied to more than one phase is by re-en- 
tering a phase defined earlier. This is permitted only for the task phase and for the 
purpose of doing SEARCHes and FINDs. 


Example 1 SEARCH Search defined libraries for 
unresolved references. 


Example 2 SEARCH A:*.EXE Search drive A: as a library of 
files with extension .EXE ona 
PC/MS-DOS system. 
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Syntax 


Description 
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SYMT 


The SYMT command causes the Link Editor to include symbol tables in the linked 
output file when the linker input files contain such symbols. These symbols were | 
provided in the assembler as a result of selecting the SYMLST option (see the © 
OPTION directive in Section 7.7). Although symbol tables make the linked 
module larger, they are useful for symbolic debugging. 


SYMT is the inverse of the NOSYMT option. 





TASK 


Syntax 


Description 


Example 1 


Example 2 


Define Phase as Task Command __TASK 


TASK [<name>] 


where <name> = the identifier of the task module. The <name> can have 
up to eight characters. The name supplied becomes the 
IDT name, placed on the last record of the object 
module produced and on the ID fields of ASCII-for- 
matted records. If the parameter is omitted, the IDT 
-~ name of the first included module is used as the task 
name. : 


The TASK command defines a phase that can be installed and executed as a task 
or standalone program, and assigns a name to the task. 


A task is either a complete program, containing both variable data and executable 
code, or it is the variable data portion of a program (procedure/task segmenta- 
tion). The TASK and PHASE 0 commands are logically identical; one and only 
one of these two commands must appear in each control stream. 


When task/procedure segmentation is used, the TASK command must follow all 
PROCEDURE commands and precede all PHASE and INCLUDE commands that 
define the task module. The TASK command can be given after overlays have been 
defined (to re-enter the root phase). 


TASK FORPRG Define task named FORPRG. | 


TASK Define task and assign it the IDT name 
of the first included module. 
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9.5 _— Examples 


| partitioning (Section 8.5.2), and a partial link (Section 8.5.3). 
_ are given for creating random and sequential libraries (Section 8.5.4). 


Examples showing how and when to use. the link <batrol commands are provided 
in this section. Among the examples are a simple link (Section 8.5.1), ROM/RAM | 
In addition, exeraples 


Three separately assembled modules, MAIN, RESET, and INTRPT, are to be linked 
together. Figure 9-1, Figure 9-2, and Figure 9-3 contain the assembly language 
source for each module. The TMS320C25 Assembler nen 990- tagged object 
code that the Link Editor requires as input. 


The first and third linking examples assume that each module is contained in a 
separate file named MAIN.MPO, RESET.MPO, and INTRPT.MPO, respectively, and 


that the three files are listed on a diskette in a TI/IBM PC (MS/PC-DOS) operating 


system. The second example is similar, but bases its file access on the VAX/VMS 


operating system: 


"MAIN! 


IDT 
* 
DEF MAIN 
REF RESET, INTRPT 
* DATA PAGE 6 RAM DEFINITION 
NEXTO EQU 0 
SAMPLE EQU 32 
* 
PSEG 
BEGIN B RESET 
INTO B INTRPT 
* 
BSS 28 
MAIN LARP AR1 
| LDPK 6 
LOOP IDLF 
LALK INPUT 
TBLR SAMPLE 
LRLK AR1,>0300+SAMPLE 
CNFP 
MPYK 0 
ZAC 
RPTK 31 
MACD >FFOO, *- 
APAC 
SACL * 
CNFD 
LALK OUTPUT 
TBLW NEXTO 
B LOOP 
PEND 
‘ | 
CSEG 'TO! 
INPUT BSS 1 
OUTPUT BSS i 
CEND 
* 
END 


Figure 9-1. Source for Module MAIN 
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RESET 


CFIR 


IDT 


DEF 
REF 
PSEG 
LARP 
LRLK 
ZAC 
RPTK 
SACL 
LRLK 
RPTK 
BLKP 
B 


DATA 
DATA 
DATA 
DATA 
PEND 


END 


'RESET' 


RESET 
MAIN 


AR1 
AR1,>0300 


35 
a4 
AR1,>0200 
31 


CFIR,*+ 
MAIN 


1762037297 7=398,493;,-566;598,—-567 
448 ,-212,-176,772,-1684,3193,8,7 
6,5,3193,-1684,772,-176,-212,448 
=567599 ;-506;493 ;- 399,297 ,—=203,176 


Figure 9-2. Source for Module RESET 
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* 


* DATA PAGE 
STATUS 


TEMP1 
TEMP2 


* 


INTRPT 


* 


INPUT 


OUTPUT 


* 


LASTIN 


LASTO 


* 


IDT 'INTRPT' 
DEF — INTRPT 
OQ RAM DEFINITION 
EQU 96 | 
EQU 97 

EQU 98 

PSEG 

SST STATUS 
LDPK 0 

IN TEMP 1, PAO 
LALK LASTIN 
TBLR TEMP 2 
TBLW TEMP 1 
LAC TEMP 2 
SUB - TEMP 1 
SACL TEMP 1 
LALK INPUT 
TBLW TEMP 1 
LALK OUTPUT 
TBLR TEMP 1 
LALK LASTO 
TBLR TEMP 2 
LAC TEMP 2 
ADD TEMP 1 
SACL TEMP 1 
OUT TEMP1,PA1 
LALK LASTO 
TBLW TEMP 1 
LST STATUS 
RET 

PEND 

CSEG 'TO! 
BSS 1 

BSS 1 

CEND 

DSEG 

BSS 1 

BSS at 

DEND 

END 


Figure 9-3. Source for Module INTRPT 
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9.5.1 Simple Linking 


Every control stream must contain either a TASK or PHASE 0 command to define the 
name of the program being linked. In addition, the control stream must contain one 
or more INCLUDE commands to define modules that are being linked. The control 
stream is terminated with an END command. The following is an example control 
stream on the TI/IBM PC MS/PC-DOS operating system for linking the three 
example object modules generated for MAIN, RESET, and INTRPT. 


PHASE O,SIMPLE 
INCLUDE MAIN.MPO 
INCLUDE RESET.MPO 
INCLUDE INTRPT.MPO 
END 


The three modules may be specified in one INCLUDE command rather than with three 
separate commands. The diskette containing the modules (A: ) may also be defined 
as a library. When this ts done, only the file name (enclosed in parentheses) need 
be specified. The Link Editor searches the defined library for the required files. An 
example of a control stream using the INCLUDE command is as follows: 


PHASE QO,SIMPLE 

LIBRARY A:*.MPO 

INCLUDE (MAIN) , (RESET) , (INTRPT) 
END 


Since MAIN references RESET and INTRPT, and the directory containing these 
modules has been defined as a library, MAIN is the only module that must be spec- 
ified in the INCLUDE command, as shown in the following example: 


PHASE O,SIMPLE 
LIBR A:*.MPO 
INCL (MAIN) 
END 


At the end of the control stream, the Link Editor automatically searches the defined 
library for unresolved references and includes the modules that satisfy the references 
in the linking process. 


The Link Editor produces a listing of the linking process and writes it to a specified 
file. Figure 9-4 is an example of the listing file produced. The listing file for this 
example consists of three pages. The first page contains a copy of the link control 
stream. The second page lists the parameters used when the Link Editor was 
initialized (access names of the control file, linked output file, and listing file) and 
the format of the linked output. Since the FORMAT command was not included in 
the control stream, the default, ASCII, is used. 


The third page contains the link map, which is generated to facilitate debugging. 
The link map lists the origins and lengths of the phase being linked, the modules 
included in the link, and any common segments. The origins are relative to the 
beginning of the phase. The order in which the included modules are linked is 
indicated by. the number listed next to the module name. The link map also lists the 
symbols defined in the included modules, indicating the module in which the symbol 
is defined (number) and the resolved location of the symbol (value). An asterisk 
(*) preceding the symbol name indicates that the symbol is not referenced in the 
included modules. An asterisk to the right means the symbolic value is absolute. 
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PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 1 


COMMAND LIST 
PHASE O,SIMPLE 
INCLUDE A:MAIN.MPO 
INCLUDE A:RESET.MPO 
INCLUDE A:INTRPT.MPO 
END 


PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 2 
LINK MAP 


CONTROL FILE = A:SIMPLE.CTL 

LINKED OUTPUT FILE = A:SIMPLE.LOD 

LIST FILE = A:SIMPLE.MAP 

OUTPUT FORMAT = ASCII 

PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:49:35 PAGE 3 
PHASE 0 . SIMPLE MODULE ORIGIN = 0000 LENGTH = 0083 


MODULE NO ORIGIN LENGTH TYPE - DATE TIME CREATOR 
MAIN 1 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 
RESET 2 0036 O02D INCLUDE 06/21/85 08:49:03 ASM320 
INTRPT 3 0063 OO1C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA 3 OO7F 0002 | 

COMMON NO ORIGIN LENGTH 

IO 1 0081 0002 


DEFINITIONS 


NAME VALUE NO NAME VALUE NO NAME VALUE NO 
-INTRPT 0063 3  #\MAIN 0020 1 RESET 0036 2 

LENGTH OF REGION FOR TASK = 0083 

NUMBER OF RECORDS FOR MODULE SIMPLE = 10 

TOTAL RECORDS WRITTEN = 10 

*k*e* LINKING COMPLETED 06/21/85 08:49:42 


Figure 9-4. Listing File for a Simple Link 
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9.5.22 ROM/RAM Partitioning 


Each example module has a program segment defined by the PSEG assembler 
directive, a data segment defined by the DSEG directive, and a common defined by 
the CSEG directive. Program segments generally contain instructions and nonvari- 
able data (read only). Data segments generally contain variable data (read/write) 
and are labeled by the Link Editor as $DATA. Common segments contain variable 
data that may be shared by more than one module. 


The Link Editor automatically reorganizes the output so that all the program segments 
of the included modules are together, followed by the data segments and then the 
common segments. The link control commands PROGRAM, DATA, and COMMON 
can be used to specify the beginning location of each output segment. These 
commands cannot be used with a PROCEDURE command or a PHASE command 
with a level greater than zero. 


The following is an example of the control stream for a VAX/VMS operating system, 
which is used to partition the program and data segments into potential ROM and 
RAM locations. 


PHASE 0, SEGMENT 

PROGRAM >0000 

DATA 22000 

COMMON >3000,I0 

INCLUDE [PROJECT .MACK]MAIN.MPO 
INCLUDE [PROJECT .MACK] RESET .MPO 
INCLUDE [| PROJECT.MACK] INTRPT.MPO 
END 


The example assumes that location >0000 is in ROM and locations >2000 and 
>3000 are in RAM. This control stream causes the program segment of MAIN to 
begin at location >O000, followed by the program segment of RESET, and then 
INTRPT. The data segment begins at location >2000. The common segment that 
is to be shared by the modules begins at location >3000. Note that if the common 
segment is not specifically named in the COMMON command, the segment begins 
immediately following the last data segment. 


Figure 9-5 contains the listing produced by this link. Use of the PROGRAM, DATA, 
and COMMON commands causes the phase length to be listed as zero and the origins 
to be listed as absolute locations. An asterisk(*) preceding the symbol name indicates 
that the symbol is not referenced in the included modules. An asterisk following the 
value of a symbol name indicates an absolute location. Linking absolute code 
generated by the assembler (AORG assembler directive) also causes the phase length 
to be listed as zero and the origins to be absolute locations. 
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VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 1 
COMMAND LIST | 


PHASE Q0,SEGMENT 
PROGRAM »>0000 
DATA >2000 


COMMON > 3000 

INCLUDE [PROJECT .MACK]MAIN.MPO 
INCLUDE [PROJECT .MACK] RESET .MPO 
INCLUDE [PROJECT .MACK] INTRPT .MPO 
END | 


VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 2 
LINK MAP 


CONTROL FILE = [PROJECT.MACK]SEGMENT.CTL 

LINKED OUTPUT FILE = [PROJECT.MACK] SEGMENT. LOD 

LIST FILE = [PROJECT.MACK] SEGMENT. MAP | 

OUTPUT FORMAT = ASCII 

VAX/32020 LINKER VERSION v.2.3 85.084 6/21/85 08:49:53 PAGE 3 
PHASE 0 SEGMENT MOBULE ORIGIN = 0000 LENGTH = 0000 


MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
MAIN 1 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 
RESET 2 0036 002D INCLUDE 06/21/85 08:49:03 ASM320 
INTRPT 3 0063 001C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA  —-3 2000 0002 

COMMON NO ORIGIN LENGTH 

IO x 3000* 0002 


DEFINITIONS 
NAME VALUE NO NAME VALUE NO NAME VALUE NO 


INTRPT O0063* 3 MAIN 0O020* 1 RESET O036* 2 
LENGTH OF REGION FOR TASK = 0000 
NUMBER OF RECORDS FOR MODULE SEGMENT = 10 
TOTAL RECORDS WRITTEN : = 10 


**k* LINKING COMPLETED 06/21/85 08:50:05 


Figure 9-5. Listing File for ROM/RAM Partitioning 





Link Editor 


9.5.3 Partial Linking 


This section shows how to generate a partial link and then include the output of the 
partial link in a subsequent link. Only ASCII object code can be used in partial linking 
on the TMS320C25 device. 


The PARTIAL command is used in the control stream to specify a partial link. In this 
example, modules RESET and INTRPT are to be linked together in a partial link. The 
Output of the partial link is not executable and must be linked again without the 
PARTIAL command so that the output of this partial link will then be linked with 
module MAIN to produce an executable module. The following is the control stream 
for the partial link, using the TI/IBM PC (MS/PC-DOS) operating system: 


PARTIAL 

PHASE O,PARTIAL 
INCLUDE A:RESET.MPO 
INCLUDE A:INTRPT.MPO 
END 


All commands pertaining to partial links must be issued before any INCLUDE, 
SEARCH, and FIND commands. The PARTIAL command must be given before the 
first INCLUDE command in the control stream. In a partial link, only one phase is 
allowed and must be defined by the PHASE 0 or TASK command. 


The ALLGLOBAL, GLOBAL, and NOTGLOBAL commands are used with the 
PARTIAL command to define the scope of DEF tags in modules included in the partial 
link. These symbols are specified as either global or local. All externally-defined 
symbols are processed as global symbols. Global symbols are externally defined in 
the partially linked output modules and may be referenced in a subsequent link. Local 
symbols are not externally defined in the partially linked output module; therefore, 
they may be referenced in the current partial link. Since none of these commands 
are included in the control stream, the default, ALLGLOBAL, is used. 


The output of the partial link can now be linked with module MAIN to produce an 
executable module, using the following control stream: 


PHASE Q,PROJ 
INCLUDE B:MAIN.MPO 
INCLUDE B:PARTIAL.MPO 
END 


The listing and object modules from a partial link using the PARTIAL command are 
given in Figure 9-6. 


The second part of the link, in which the output of the partial link is relinked without 
using the PARTIAL command, is performed next. The listing and object files for 
relinking the output of the partial link are shown in Figure 9-7. 
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PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:09 PAGE 1 
COMMAND LIST - 


PARTIAL 

PHASE Q,PARTIAL 
INCLUDE A:RESET.MPO 
INCLUDE A:INTRPT.MPO 
END : | 


PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:09 PAGE 2 
LINK MAP - 


CONTROL FILE = A:PARTIAL.CTL 

LINKED OUTPUT FILE = A:PARTIAL.MPO 

LIST FILE = A:PARTIAL.MAP 

OUTPUT FORMAT = ASCII 

PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:09 PAGE 3 
PHASE 0 PARTIAL MODULE ORIGIN = 0000 LENGTH = 004D 

MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 
RESET 1 0000 002D INCLUDE 06/21/85 08:49:03 ASM320 


INTRPT 2 002D O001C INCLUDE 06/21/85 08:49:18 ASM320 
SDATA 2 0000 0002 


COMMON NO ORIGIN LENGTH 
IO 2 0000 0002 

DEFINITIONS 
NAME VALUE NO NAME VALUE NO 


*INTRPT O002D 2 *RESET 0000 1 
UNRESOLVED REFERENCES 


MAIN aL 

LENGTH OF REGION FOR TASK = 004D 
NUMBER OF UNRESOLVED REFERENCES = ug 
NUMBER OF RECORDS FOR MODULE PARTIAL = 9. 


TOTAL RECORDS WRITTEN = 9 
**** LINKING COMPLETED 06/21/85 08251217 


a. Listing File for a Partial Link 


Figure 9-6. Listing and Object Files for a Partial Link 
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KOO49PARTIAL MOOO2SDATA OQOOOMOOO02I0O O00250000RESET 5002DINTRPT7FOEAF 
40000MAIN AOOOO0B5589BD100B0300BCAOOBCB2 3B60A0BD1LOOBO200BCB1IFBFCAO7F136F 
COOODBFF80EQOOQQ0Q000BOOBOBFF35B0129BFE72B01EDBFDCABO256BFDC9BO1CO7F140F 
BFF2CBFF50B0304BF96CBOC79BO008B000 7BOO06BO0005B0C7 9BF96CBO304BFF507F12EF 
BFF2CBO1COBFDC9B0256BFDCABO1EDBFE72B012 9BFF35BOOBOA002DB7860BC8007FOC4F 
B8061BD001T0000B5862B5961B2062B1061B6061BD001NO0000002B5961BD0017F225F 
NO0010002B5861BD001T0001B5862B2062B0061B6061BE161BD001T0001B59617F219F 


B5060BCE267FD8AF 
PARTIAL 06/21/85 08:51:09 XLNKPC v2.3 85.084 


b. Object File for a Partial Link 


Figure 9-6. Listing and Object Files for a Partial Link (Concluded) 


The second part of the link, in which the output of the partial link is relinked without 
using the PARTIAL command, is performed next. The listing and object files for 
relinking the output of the partial link are shown in Figure 9-7. 
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Oo eeeeaisce Family Linker v.2.3 85.084 6/21/85 O8: ne 33 PAGE. 1 
ee List 


PHASE -  0,PROJ 
INCLUDE A:MAIN.MPO 
INCLUDE A:PARTIAL.MPO 
END 


PC /CrossWare eaniiy Linker v.2.3 85.084 6/21/85 08:51: 33 PAGE 2 
LINK MAP 


CONTROL FILE = A:PROJ.CTL | 

LINKED OUTPUT FILE = A:PROJ.LOD 

LIST FILE = A:PROJ.MAP | 

OUTPUT FORMAT = ASCII 

PC/CrossWare Family Linker v.2.3 85.084 6/21/85 08:51:33 PAGE 3 
PHASE 0 PROJ MODULE ORIGIN = 0000 LENGTH = 0083 

MODULE NO ORIGIN LENGTH TYPE DATE TIME CREATOR 

MAIN 1 0000 0036 INCLUDE 06/21/85 08:48:34 ASM320 

PARTIAL 2 0036 0049 INCLUDE 06/21/85 08:51:09 XLNKPC 

SDATA Z OO7F 0002 

COMMON NO ORIGIN LENGTH 


IO - 0081 0002 


DEFINITIONS 


NAME VALUE NO NAME VALUE NO NAME VALUE NO 
INTRPT 0063 2 °&MAIN 0020 1 RESET 0036 2 
LENGTH OF REGION FOR TASK = 0083 

NUMBER OF RECORDS FOR MODULE PROJ = 10 

TOTAL RECORDS WRITTEN = 10 

**** LINKING COMPLETED 06/21/85 08:51:40 


a. Listing File for Relinking the Partial Link Output 


KOO083PROJ AOQOOOBFF80CO036BFF80C006 3A0020B5589BC806BCEI1FBDOO017F1D8F 
COO81B5820BD100B0320BCEO5BAOOOBCAOOBCBI1FB5C90BFFOOBCE15B6080BCE047F129F 
BDOO1CO082B5900BFF80C0022A0036B5589BD100B0 300BCAOOBCB2 3B60A0BD1007F193F 
BOZ00BCB1FBFCAO0COO043BFF80CO020BOO0OBOBFF35B0129BFE72B01EDBFDCAB02567FOEDF 
BFDC9BO.1LCOBFF2CBFF50B0 304BF96CBOC7 9BOO08B000 7BOOO06BO005B0C79BF9I6C7F10CF 
BO304BFF50BFF2CBO1COBFDC9BO256BFDCABO1EDBFE72B0129BFF35BOOBOA00637FOC9F 
B7860BC800B8061BD001C007FB5862B5961B2062B1061B6061BD001C0081B59617F1COF 
BD001C0082B5861BD001C0080B5862B2062B0061B606 1BE161BD001C0080B59617F1DAF 
B5060BCE267FD8AF 
PROJ 06/21/85 OSssi2e33 XLNKPC v2.3 85.084 


b. Object File for Relinking the Partial Link Output 


Figure 9-7. Listing and Object Files for Relinking the Partial Link Output 
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9.5.4 Library Creation 
The linker can accommodate two object library types: random and sequential. 


A random library can be created almost automatically. Whenever one or more object 
files are placed in the same directory or sub-directory, that directory becomes a 
random library. Some examples of random libraries are as follows: 


DUAO:[USERO7.PROJ2710.PARTS] 
(VAX), where the example indicates a directory containing 
object file members named _ (e.g., PART1.OBJ, 
INITIAL.OBJ, CLEANUP.OBJ, etc.). 


A:*.MPO (MS-DOS), where the name indicates a drive and all files 
with the extension .MPO (e.g., QUICK.MPO, BTREE.MPO, 
SHELL.MPO, etc.). 


The creation of sequential libraries is more involved. Since sequential libraries offer 
no advantages over random libraries, their use is probably restricted to those users 
of systems not supporting random libraries, i.e., not supporting multilevel directories 
or “wild-card” file specifications. 


A sequential library is a single file and consists of a “dictionary,” followed by one 
or more concatenated object modules. The user must order the elements in a 
sequential library so that no object segment contains an external reference to a 
preceding segment. The concatenated object files may be created by assembling a 
source file created by concatenating the source files of several proposed members 
of the sequential library. Such a source file may appear as shown in Figure 9-8. 


IDT 'TRESRT' 
TITL 'THIS IS THE FIRST LIB MEMBER' 
DEF TRESRT,QUICK 

* 


QUICK EQU $ 


TRESRT EQU. § 


END 
* 
IDT ‘ELEM! 
TITL 'STILL IN SEQ LIB! 
DEF ELEM 
END 
* 
IDT  'LASTPROG' 


TITL ‘ET CETERA' 


END 


Figure 9-8. Source File for Sequential Library Creation 
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The assembler output contains all modules within the same file, yet distinct. The use 
of a text editor allows the creation of such a file by appending the object files that 
result from independent assembly of the proposed library members. The dictionary 
structure must be created by use of the text editor. It precedes the first object module 
and must match the following pattern: 


First line, the library ‘IDT’ record: OlillaaaaaaaaF 


where O = tag 
Ill = length of the dictionary 
aaaaaaaa = library name 
F = end-of-record tag 
user-defined information out to 80th character 


Example: OOOOOSEQLIBO1F 04/10/85 08:15:00 


One entry for each object module included in the library: 
Fillllaaaaaaaa; | 


where F = tag 
| = 1DT marker 
lll = length of PSEG of module 
aaaaaaaa = IDT of the module 
= record end marker 


Example: FIOOCEFASTSORT; 


For each DEF within a module: FEtllllaaaaaa{,tilllaaaaaa}; 


where F = tag 
E = tag | 
= type of DEF ("A" = absolute, “R" = relative) 
Ill = value of the DEF’d symbol 
aaaaaa = 6-character name of symbol DEF’d in this module 
, = if more (up to five DEFs allowed per record 
; = if no more 


Example: FEAOO50PACK ,ROOACUNPAK ,AQEOSENCODE; 


For each REF within the module: FR aaaaaa{, aaaaaa} 


where F = tag 
R = tag 
’ ’ = five blanks 
aaaaaa = 6-character name of symbol REF’d 
, = if more (up to five REFs allowed per record) 
; = if no more 


Example: FR EXREF , ESYM, X 


For each COMMON segment contained within the module: 
FCilllaaaaaa{,|illaaaaaa}; 


where F = tag 
C = tag 
lil = length of COMMON segment 
aaaaaa = 6-character COMMON segment name 
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Example: FCO140COMNAM,0266SBLANK; 


For each DATA segment defined within the module: 


FDIIII {UI 
where F = tag 
D = tag 
lil = length of DATA segment 


’ = six blanks 
up to five DSEGs allowed, separated by commas 
terminated by ; 


Example: FD0010 ,0032 


This set of records is repeated for each object module in the library. The final record, 
just prior to the first record of the first library member, must contain a colon in the 
first character position. The remainder of this colon record is not specified. It can 
be used for date, time, and other user-defined information. 


9.6 Link Editor Error Messages 


Messages are listed for detected errors in the listing file. The Link Editor error 
messages are named and described below. 


When the error-message description indicates that a malfunction of the link editor 
has occurred, please contact the Texas Instruments Customer Response Center 
(CRC) hotline number, 1-800-232-3200, extension 2171, for assistance. WE E14 


‘(’ EXPECTED: The REPLACE command expects a parenthesis. 2320 


ADDRESS SPACE HAS OVERFLOWED IN THIS MODULE: The maximum 
address required to represent this module is >10000 or greater. No valid object 
module can be produced for this phase. The linker continues to produce the map, 
but with increased likelihood that it will abort from internal errors. 


ADDRESS SPACE TRUNCATED FOR TAG = X IN THE SEGMENT START- 
ING AT YYYY: The 320-specific tags have a seven-bit address field that has 
overflowed. 


ALIGNMENT VALUE MUST BE IN THE RANGE 0..15: The value in the 
ADJUST command is out of range. 


AN ACTIVE BUFFER SHOULD HAVE BEEN CLOSED: A buffer that needs to 
be closed is still marked as active. 


ATTEMPT MADE TO WRITE TO A NIL SEGMENT: The linker attempted to 
write to a nonexistent segment. Indicates a malfunction of the link editor; call hotline 
immediately. 


ATTEMPT MADE TO WRITE TO INACTIVE SEGMENT: The linker has 
attempted to write to an unopen segment. Indicates a malfunction of the link editor; 
call hotline immediately. 


ATTEMPT TO ACTIVATE AN ALREADY ACTIVE SEGMENT: The linker has 
attempted to open a segment that is already active. Indicates a malfunction of the 
link editor; call hotline immediately. 
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ATTEMPT TO ACTIVATE NIL SEGMENT: The linker has attempted to open a 
nonexistent segment. Indicates a malfunction of the un editor; call hotline imme- 
diately. 


ATTEMPT TO ALLOCATE AFTER DSEG OF CSEG DEFINED: The ALLOCATE 
command has been given after data and/or common segments have been encount- 
ered. 


ATTEMPT TO MOVE NON-COMMON SEGMENT: An attempt has been made — 
to move a segment that is not a common. Indicates a malfunction of the link editor; 
call hotline immediately. 


ATTEMPT TO ORDER A NIL SEGMENT: A common that was never defined 


cannot be placed in the stream of commons. Indicates a malfunction of the link 


editor; call hotline immediately. 


ATTEMPT TO REDEFINE COMMON ORIGIN: Directives to sites a common 


origin provide information that conflicts with information that has been already 


determined. 


BAD CHAIN FOR XXXX TO YYYY: Ina partial link, the reference chain for XXXX 
points to the address YYYY that is outside the scope of the segment. 


BAD INDEX - COMMAND FORMAT NOT RECOGNIZED: In a partial link, 
an error was detected in the control record such that the current index is negative. 


BAD TAG IN CHAIN FOR XXXX AT YYYY: Ina partial link, an invalid tag was 
encountered in the processing of the reference chain. If this error occurs, the object 
module has been damaged. | 


CANNOT ORDER COMMONS FROM DIFFERENT MODULES: Commons 
that are overlayed in procedures of the same phase level cannot be ordered together. 
This usually occurs in a partial link. 


CAN’T ASSIGN LUNO TO LIBRARY: The limit has been exceeded in the number 
of files that can be opened at one time. 


CAN’T OPEN FILE: A file that should be opened cannot be opened. The system 
return code is identified in the immediate preceding warning. 


CAN’T OPEN LIBRARY: An error code was returned or an attempt made to open 


the directory. 


CHAIN TO UNINITIALIZED LOCATION FOR XXXX AT YYYY: The reference 
chain for value XXXX points from YYYY to an insignificant address. Perea of 
the chain is discontinued. 


COMMAND NOT VALID WITH PARTIAL LINK: The specified command is not 
valid in producing a partial link. 


COMMAND ONLY VALID WITH PARTIAL LINK: The GLOBAL, NOTGLOBAL, 


and ALLGLOBAL commands must follow a PARTIAL command in a control stream. 


COMMON HAS NOT BEEN PLACED VALIDLY: An attempt has been made 
to place a common at two or more locations. 


COMMON NAME TRUNCATED: The common name has been truncated to six 
characters. This is a trivial warning and processing proceeds with the truncated name. 


COMMON NUMBER INVALID: The common number given an M tag is not in 


— the valid range. 
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COMMON ORIGIN HAS ALREADY BEEN SET: An attempt has been made to 
define a common origin already set with a previous COMMON command. 


COMMON ORIGIN INVALID: The origin for a common is not valid. 


COMMON ORIGIN WAS NOT DEFINED: The first common name specified in 
a COMMON command was never defined in the link. 


COMMON SEGMENT HAS NO SYMBOL DEFINED: Asymbol has been given 
for a common segment, but the segment itself does not exist. 


COMMON SYMBOL IS NOT VALID: The given common symbol is not legal. 


COMMON SYMBOL WAS NEVER DEFINED: A common segment was not 
found corresponding to the common symbol. 


COMPRESSED FORMAT NOT SUPPORTED FOR 320 INPUT MODULES: 
The linker only recognizes ASCll-formatted input modules for these object codes. 


CONFLICTING COMMON SYMBOL FOUND: A common symbol that is not 
consistent with previous commons has been detected. 


CURRENT SEGMENT HAS NOT BEEN DEACTIVATED: The segment that 
should be closed has been left active. 


DUPLICATE SYMBOL DEFINITION ENCOUNTERED: Two definitions have 
been encountered for the same external symbol. 


ENTRY NAME TRUNCATED: The entry name has been truncated to six char- 
acters. This is a trivial warning and processing proceeds with the truncated name. 


EXTERNAL REFERENCE INDEX OUT OF RANGE: The index number specified 
by an E tag in an input object module is not valid. | 


EXTERNAL SYMBOL TRUNCATED: A symbol specified in a GLOBAL or 
NOTGLOBAL command exceeds six characters in length. 


FATAL ERROR DETECTED -- *LINKER ABORTING”*: An error that the linker 
cannot recover from has been detected. The user should repeat the process. If the 
message occurs again, then either check the procedures used or call the hotline for 
assistance. | 


FIRST PHASE HAS ALREADY BEEN DEFINED: A NOMAP command has 
appeared after a TASK or a PHASE command has been issued in the control stream. 


HEAP ERROR ENCOUNTERED IN PASS2: A heap error was detected while 
trying to allocate data space for the second pass. Indicates a malfunction of the link 
editor; call hotline immediately. 


ILLEGAL INTERMEDIATE TAG ENCOUNTERED AT XXXX: An encoded tag 
was encountered that was not valid. Indicates a malfunction of the link editor; call 
hotline immediately. 


ILLEGAL TAG FOUND IN INTERMEDIATE FILE; TAG=X: An invalid tag was 
found in the intermediate file. Indicates a malfunction of the link editor; call hotline 
immediately. 


INTERMEDIATE FILE OVERFLOW: The maximum number of records for inter- 
mediate object representation has been exceeded. Obtain more file space by making 
individual object modules smaller or call the hotline for assistance. 


INTERMEDIATE RECORD NUMBER INVALID: The record index for the 
intermediate storage is not in the legal range. 
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INTERNAL LINKER ERROR IN AUTOCALL: An error has occurred in the > 
automatic-call algorithm. This error should never occur. If it does, unresolved 


_ references may be the result of modules not having been read in; in other respects, 
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the object module produced should be good. Relink using epee INCLUDES for 
the missing modules or call the hotline for assistance. 


INVALID ATTEMPT TO MOVE FIRST COMMON: The linker has attempted 
to move a common that was specified as the first common by a COMMON command. 
Indicates a malfunction of the link editor; call hotline immediately. 


-INVALID ATTEMPT TO READ BUFFER: The linker has attempted to activate a 


buffer that is not of the correct type. Indicates a malfunction of the link editor; call 
hotline immediately. 3 | 


INVALID LEVEL FOR PHASE: The level argument to a PHASE command is not 
appropriate. The first phase established must be a TASK or a phase of level 0. If the 
current level is N, a new phase must have level < N+1. 


INVALID PROCEDURE LEVEL: The level for procedures must be 1 or 2. 


INVALID PROCEDURE SPECIFIED: An illegal procedure has been declared. 


INVALID SYMBOL NAME FOR REPLACE: The REPLACE command has 
encountered an illegal symbol name. 


INVALID VALUE FOR LINES PER PAGE: The argument to a page command 
is not recognized as a positive integer or is out of the range of 16 to 60 lines per page. 


LAST COMMON IN LIST IS NIL: The last common in a list of ordered commons 
does not exist. Indicates a malfunction of the link editor; call hotline immediately. 


LAST MODULE FOR PHASE IS NIL: The linker cannot find the information 
about the current phase. Indicates a malfunction of the link editor; call hotline 
immediately. | | 


MAP RECORD INDEX IS OUT OF RANGE: The map record is full or the index 
has been changed to an invalid value. Indicates a malfunction of the link editor; call 
hotline immediately. 


MEMBER NAME TOO LONG: The member name exceeds eight characters. The 
command is not processed. 


MEM BER NAME TRUNCATED: The member name has been truncated to eight 
characters. This is a trivial warning and processing proceeds with the truncated name. 


MINIMUM NUMBER OF LINES PER PAGE IS 16: A PAGE N command may 
not specify a value of N less than 16. 


MODULE LENGTH IS ZERO: The length for the module has been incorrectly 
specified as zero. 


MODULE ORIGIN IS NOT ZERO: The origin for a module must be zero before 
the relocation is applied. 


NIL COMMON SEGMENT WAS ACTIVATED: An attempt was made to activate 
a common segment that does not exist. 


NIL SEGMENT FOR M TAG SYMBOL: An M tag definition applies to a segment 
that does not exist. Indicates a malfunction of the link editor; call hotline immediately. 
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NO PHASE IS DEFINED: No PROCEDURE, TASK, or PHASE 0 has been defined. 
A command has been given which requires that object modules be read in or that 
some phase be active. 


NO TASK PHASE Is DEFINED: No TASK or PHASE 0 has been defined. A valid 
set of linked object modules cannot be produced. 


NOTGLOBAL MUST PRECEDE A GLOBAL COMMAND: The GLOBAL 
command is only valid if it is preceded by a NOTGLOBAL command with no 
parameter. 


OBJECT CARD INDEX ERROR DETECTED: After writing an object record, the 
index into the record was not equal to one. Indicates a malfunction of the link editor; 
call hotline immediately. 


ORIGIN CANNOT BE WRITTEN TO INACTIVE SEGMENT: The linker has 
attempted to write origin information to a segment that is not open. Indicates a 
malfunction of the link editor; call hotline immediately. 


OVERWRITTEN BLOCKS FOR XXXX TO YYYY: on placed object code 
overlaps at the given address. 


OVERWRITTEN SEGMENTS’ STARTING AT XXXX IN MODULE 
NNNNNNNN: Overlapping segments have been detected starting at location 
XXXX. The link map specifies which segment starts at that point. This is flagged 
as a warning. 


PARTIAL COMMAND INVALID IN CONTEXT: The PARTIAL command was 
specified in the control stream after a command that is inconsistent with partial links 
(e.g., DUMMY, PROGRAM, DATA, COMMON, ALLOCATE, PROCEDURE, PHASE 
1, etc.) 


PHASE LEVEL EXPECTED: The level argument to a PHASE command must be 
a zero or a positive integer. 


PHASE LEVEL SPECIFIED IS NOT VALID: The level specified in a PHASE 
command is not in the valid range. 


PHASE NAME TRUNCATED: The phase name has been truncated to eight 
characters. This is a trivial warning, and processing proceeds with the truncated 
name. 


PHASE SEQUENCE IS NOT VALID: The order in which the phases have been 
declared is not legal. 


PREMATURE END OF CONTROL FILE: The control file has ended before an 
END command was encountered. No further processing is done. 


PROCEDURE CANNOT HAVE BROTHERS: A procedure cannot have phases 
at the same level defined with it. 


PROCEDURE NAME TRUNCATED: The procedure name has been truncated 
to eight characters. This is a trivial warning, and processing proceeds with the 
truncated name. 


PROC 1 MUST BE DUMMIED TO DUMMY PROC 2: In order to dummy the 
second procedure, the first procedure must also be dummied. 


PROC 1 SYMBOL NUMBER IS NOT ZERO: The symbol number for the 
procedure must be zero. 


PROC 2 SYMBOL NUMBER IS NOT ZERO: The symbol number for the 
procedure must be zero. 
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RELOCATABLE ADDRESS. _IS NOT VALID; SEGMENTS. SHOULD BE 
PLACED AT ABSOLUTE LOCATIONS: Certain TMS320- specific tags require 
that segments. to which they refer be placed at absolute addresses. 


SEGMENT BUFFER HAS BEEN DAMAGED: The current segment does not 


contain the expected information. Indicates a malfunction of the link editor; call 


hotline immediately. 


~ SEGMENT ORIGIN IS ZERO: The origin for a segment has erroneously changed 
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to zero. Indicates a malfunction of the link editor; call hotline immediately. 
TASK OR PHASE 01S ALREADY DEFINED: A PROCEDURE command cannot 


_ be given once a task phase has been defined. | 


TASK OR PHASE 0 MUST BE DEFINED BEFORE OVERLAY: An overlay has 
been defined before the task or root phase. : 


THE CURRENT SEGMENT IS NIL: ‘The segment that is being examined does 
not exist. Indicates a malfunction of the link editor; call hotline immediately. 


THE INPUT OBJECT MODULE HAS BEEN DAMAGED: Unexpected or invalid 
tags and values have been encountered in the input object module. 


THE MAP RECORD IS NIL: An attempt. has been made to place information into 
the map record when the record does not exist. Indicates a malfunction of the link 
editor; call hotline immediately. 


THE OVERWRITTEN BLOCKS ARE NOT COM PATIBLE:. The types of the 
overlapping blocks are not the same, and a valid object module cannot be produced. 


THE PHASE TYPE IS NOT TASK, OVLY, OR PROC: This error should never 
occur, because the only valid types are TASK, OVLY, and PROC. 


THE SEGMENT TYPE!IS NOT PSEG, DSEG, OR CSEG: The only valid segment 
types are PSEG, DSEG, and CSEG. 


TOO MANY SYMBOLS HAVE BEEN DEFINED: The statically allocated arrays 
that contain the values for symbols (mostly external symbols and phase lengths, 
onan: etc.) have overflowed. The number of symbols allowed in a symbol table is 


UNABLE TO PROPERLY ORDER COMMONS: The linker cannot order the 
commons as specified. 


UNEXPECTED TAG: The input aioe micdule is not of the expected format. It 
may not really be an object module. Processing stops. 


UNRECOGNIZED FORMAT: The argument to the FORMAT command is not 
recognized. 


UNRECOGNIZED COMMAND: The command on the most recent line is not 
recognized as a linker command. The line is ignored. | 


UNSUPPORTED INTER-SEGMENT LINK FOR XXXX FROM YYYY TO 
Z2ZZZ: This message is printed by the second pass, and applies to the module in 
the linked output that is.next identified. An external reference chain has pointed from 
one PSEG, DSEG, or CSEG into another. XXXX‘is the value of the external symbol 
to be filled in. (The second pass cannot identify it by symbol name. The name can 
often. be found by examining the symbol definitions. A symbol with a value of zero 
may be an unresolved reference.) YYYY, the address where the chain starts, identifies 
the offending module. ZZZZ is the address to which the chain points. The only 
deficiency in the linked object is that. incorrect values remain where the value of 
external symbol XXXX should have been inserted. 
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- PIN NOMENCLATURE 
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5-V supply pins 
Ground pins 




































Output from internal oscillator for crystal 













X2/CLKIN 
CLKOUT1 
CLKOUT2 
D15-DO 


Input to internal oscillator from crystal or external clock 

Master clock output (crystal or CLKIN frequency/4) 

A second clock output signal 

16-bit data bus D15 (MSB) through DO (LSB). Multiplexed between program, data, and 0 
‘spaces. 

16-bit address bus’: A15 (MSB) through AO (LSB) 

Program, data, and I/O space select signals 

Read/write signal 

Strobe signal 

Reset input 








External user interrupt inputs 
Microprocessor/microcomputer mode select pin 
Microstate complete signal 

Interrupt acknowledge signal 

Data ready input. Asserted by external logic when using slower devices to indicate that the 
current bus transaction is complete. | 

Bus request signal. Asserted when the TMS320C25 requires access to an external global 
data memory space. 

External flag output (latched software- areararnneble signal) 

Hold input. When asserted, TMS320C25 goes into an idle mode and places the data, address, 
and control lines in the high-impedance state. 

Hold acknowledge signal 

Synchronization input 

Branch control input. Polled by BIOZ instruction. 

Serial data receive input 

Clock for receive input for serial port 

Frame synchronization pulse for receive input 

Serial data transmit output 

Clock for transmit output for serial port 

Frame synchronization pulse for transmit. Configurable as either an input or an output. 


t1/O/Z denotes input/output/high-impedance state. 


description 


The TMS320C25 Digital Signal Processor is a member of the TMS320 family of VLSI digital signal processors 
and peripherals. The TMS320 family supports a wide range of digital signal processing applications, such 
as telecommunications, modems, image processing, speech processing, spectrum analysis, audio 
processing, digital filtering, high-speed control, graphics, and other computation-intensive applications. 


With a 100-ns instruction cycle time and an innovative memory configuration, the TMS320C25 performs 
operations necessary for many real-time digital signal processing algorithms. Since most instructions require 
only one cycle, the TMS320C25 is capable of executing ten million instructions per second. On-chip data 
RAM of 544 16-bit words, on-chip program ROM of 4K words, direct addressing of up to 64K words of 
external data memory space and 64K words of external program memory space, and multiprocessor 
interface features for sharing global memory minimize unnecessary data transfers to take full advantage 
of the capabilities of the processor . 
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architecture 


The TMS320C25 architecture is based upon that of the TMS32020, the second member of the TMS320 
family. The TMS320C25 increases performance of DSP algorithms through innovative additions to the 
TMS320 family architecture. TMS32020 source code is upward-compatible with TMS320C25 source code 
and can be assembled using the TMS320C25 Macro Assembler. TMS32020 object code will run directly 
on the TMS320C25. 


Increased throughput on ‘hie TMS320C25 for many DSP sinaieatada is accomplished by means of single- 
~ cycle multiply/accumulate instructions with a data move option, eight auxiliary registers with a dedicated 
arithmetic unit, and faster I/O necessary for data-intensive signal processing. ? 


The architectural design of the TMS320C25 emphasizes overall speed, communication, and flexibility in 
processor configuration. Control signals and instructions provide floating-point support, block-memory 
transfers, communication to slower off-chip devices, and multiprocessing implementations. 


Two large on-chip RAM blocks, configurable either as separate program and data spaces or as two 
contiguous data blocks, provide increased flexibility in system design. Programs of up to 4K words can 
be masked into the internal program ROM. The remainder of the 64K-word program memory space is located 
externally. Large programs can execute at full speed from this memory space. Programs can also be 
downloaded from slow external memory to high-speed on-chip RAM. A total of 64K data memory address 
space is included to facilitate implementation of DSP algorithms. The VLSI implementation of the 
TMS320C25 incorporates all of these features as well as many others, such as a hardware timer, serial 
port, and block data transfer capabilities. | 


32-bit ALU/accumulator 


The TMS320C25 32-bit Arithmetic Logic Unit (ALU) and accumulator perform a wide range of arithmetic 
and logical instructions, the majority of which execute in a single clock cycle. The ALU executes a variety 
of branch instructions dependent on the status of the ALU or a single bit in a word. These instructions 
provide the following capabilities: . 


e Branch to an address specified by the accumulator 
e Normalize fixed-point numbers contained in the accumulator 
e Test a specified bit of a word in data memory. 


One input to the ALU is always provided from the accumulator, and the other input may be provided from 
the Product Register (PR) of the multiplier or the input scaling shifter which has fetched data from the 
RAM on the data bus. After the ALU has performed the arithmetic or regiee! operations, the result is stored 
in the accumulator. 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory. Additional shifters 
at the output of the accumulator perform shifts while the data is being transferred to the data bus for 
storage. The contents of the accumulator remain unchanged. 


scaling shifter 


The TMS320C25 scaling shifter has a 16-bit input connected to the data bus and a 32-bit output connected 
to the ALU. The scaling shifter produces a left shift of O to 16 bits on the input data, as programmed 
in the instruction. The LSBs of the output are filled with zeroes, and the MSBs may be either filled with 
zeroes or sign-extended, depending upon the status programmed into the SXM (sign-extension mode) bit | 
of status register STO. 
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16 x 16-bit parallel multiplier 


The TMS320C25 has a 16 x 16-bit hardware multiplier, which is capable of computing a signed or unsigned 
32-bit product in a single machine cycle. The multiplier has the following two associated registers: 


e A 16-bit Temporary Register (TR) that holds one of the operands for the multiplier, and 
e A 32-bit Product Register (PR) that holds the product.. 


Incorporated into the TMS320C25 instruction set are single-cycle multiply/accumulate instructions that 
allow both operands to be processed simultaneously. The data for these operations may reside anywhere 
in internal or external memory, and can be transferred to the multiplier each cycle via the program and 
data buses. 


Four product shift modes are available at the Product Register (PR) output that are useful when performing 
multiply/accumulate operations, fractional arithmetic, or justifying fractional products. | 


timer 


The TMS320C25 provides a memory-mapped 16-bit timer for control operations. The on-chip timer (TIM) 
register is a down counter that is continuously clocked by CLKOUT1. A timer interrupt (TINT) is generated 
every time the timer decrements to zero. The timer is reloaded with the value contained in the period (PRD) 
register within the next cycle after it reaches zero so that interrupts may be programmed to occur at regular 
intervals of PRD +1 cycles of CLKOUT1. 


memory control 


The TMS320C25 provides a total of 544 16-bit words of on-chip data RAM, divided into three separate 
blocks (BO, B1, and B2). Of the 544 words, 288 words (blocks B1 and B2) are always data memory, and 
256 words (block BO) are programmable as either data or program memory. A data memory size of 544 
words allows the TMS320C25 to handle a data array of 512 words (256 words if on-chip RAM is used 
for program memory), while still leaving 32 locations for intermediate storage. When using block BO as 
program memory, instructions can be downloaded from external program memory into on-chip RAM and 
then executed. 


When using on-chip program RAM, ROM, or high-speed external program memory, the TMS320C25 runs 
at full speed without wait states. However, the READY line can be used to interface the TMS320C25 
to slower, less-expensive external memory. Downloading programs from slow off-chip memory to on-chip 
program RAM speeds processing while cutting system costs. 


The TMS320C25 provides three separate address spaces for program memory, data memory, and 1/O. 
The on-chip memory is mapped into either the 64K-word data memory or program memory space, depending 
upon the memory configuration. The CNFD (configure block BO as data memory) and CNFP (configure 
block BO as program memory) instructions allow dynamic configuration of the memory maps through 
software. Regardless of the configuration, the user may still execute from external program memory. 


The TMS320C25 has six registers that are mapped into the data memory space: a serial port data receive 
register, serial port data transmit register, timer register, period register, interrupt mask register, and global 
memory allocation register. 
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(a) MEMORY MAPS AFTER A CNFD INSTRUCTION 
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(b) MEMORY MAPS AFTER A CNFP INSTRUCTION 


FIGURE 1. MEMORY MAPS 
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interrupts and subroutines 


The TMS320C25 has three external maskable user interrupts INT2-INTO, available for external devices that 
interrupt the processor. Internal interrupts are generated by the serial port (RINT and XINT), by the timer 
(TINT), and by the software interrupt (TRAP) instruction. Interrupts are prioritized with reset (RS) having 
the highest priority and the serial port transmit interrupt (XINT) having the lowest priority. All interrupt 
locations are on two-word boundaries so that branch instructions can be accommodated in those locations 
if desired. 


A built-in mechanism protects multicycle instructions from interrupts. If an interrupt occurs during a 
multicycle instruction, the interrupt is not processed until the instruction is completed. This mechanism 
applies both to instructions that are repeated or become multicycle due to the READY signal. 


external interface 


The TMS320C25 supports a wide range of system interfacing requirements. Program, data, and I/O address 
spaces provide interface to memory and I/O, thus maximizing system throughput. I/O design is simplified 
by having I/O treated the same way as memory. I/O devices are mapped into the I/O address space using 
the processor's external address and data busses in the same manner as memory-mapped devices. Interface 
to memory and I/O devices of varying speeds is accomplished by using the READY line. When transactions 
are made with slower devices, the TMS320C25 processor waits until the other device completes its function 
and signals the processor via the READY line. Then, theTMS320C25 continues execution. 


A serial port provides communication with serial devices, such as codecs, serial A/D converters, and other 
serial systems. The interface signals are compatible with codecs and many other serial devices with a 
minimum of external hardware. The serial port may also be used for intercommunication between processors 
in multiprocessing applications. 


The serial port has two memory-mapped registers: the data transmit register (DXR) and the data receive 
register (ORR). Both registers operate in either the byte mode or 16-bit word mode, and may be accessed 
in the same manner as any other data memory location. Each register has an external clock, a framing 
synchronization pulse, and associated shift registers. One method of multiprocessing may be implemented 
by programming one device to transmit while the others are in the receive mode. 


multiprocessing 


The flexibility of the TMS320C25 allows configurations to satisfy a wide range of system requirements. 
The TMS320C25 can be used as follows: 


A standalone processor 

A multiprocessor with devices in parallel 

A slave/host multiprocessor with global memory space 

A peripheral processor interfaced via processor-controlled signals to another device. 


For multiprocessing applications, the TMS320C25 has the capability of allocating global data memory space 
and communicating with that space via the BR (bus request) and READY control signals. Global memory 
is data memory shared by more than one processor. Global data memory access must be arbitrated. The 
8-bit memory-mapped GREG (global memory allocation register) specifies part of the TMS320C25’s data 
memory as global external memory. The contents of the register determine the size of the global memory 
space. If the current instruction addresses an operand within that space, BR is asserted to request control 
of the bus. The length of the memory cycle is controlled by the READY line. 


The TMS320C25 supports DMA (direct memory access) to its external program/data memory using the 
HOLD and HOLDA signals. Another processor can take complete control of the TMS320C25’s external 
memory by asserting HOLD low. This causes the TMS320C25 to place its address, data, and control 
lines in a high-impedance state, and assert HOLDA. 
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instruction set 


The TMS320C25 microprocessor implements a comprehensive instruction set that supports both numeric- 
intensive signal processing operations as well as general-purpose applications, such as multiprocessing 
and high-speed control. The TMS32020 source code is upward-compatible with TMS320C25 source code. 
TMS32020 object code runs directly on the TMS320C25. 


For maximum throughput, the next instruction is prefetched while the current one is being executed. Since 
the same data lines are used to communicate to external data/program or I/O space, the number of cycles 
may vary depending upon whether the next data operand fetch is from internal or external program memory. 
Highest throughput is achieved by maintaining data memory on-chip and using either internal or fast external 
program memory. 


addressing modes 


The TMS320C25 instruction set provides three memory addressing modes: direct, indirect, and immediate 
addressing. 


Both direct and indirect addressing can be used to access data memory. In direct addressing, seven bits 
of the instruction word are concatenated with the nine bits of the data memory page pointer to form the 
16-bit data memory address. Indirect addressing accesses data memory through the eight auxiliary registers. 
In immediate addressing, the data is based on a portion of the instruction word(s). 


In direct memory addressing, the instruction word contains the lower seven bits of the data memory address. 
This field is concatenated with the nine bits of the data memory page pointer to form the full 16-bit address. 
Thus, memory is paged in the direct addressing mode with a total of 512 pages, each page containing 
128 words. 


Eight auxiliary registers (ARO-AR7) provide flexible and powerful indirect addressing. To select a specific 
auxiliary register, the Auxiliary Register Pointer (ARP) is loaded with a value from O through 7 for ARO 
through AR7, respectively. 


There are seven types of indirect addressing: auto-increment or auto-decrement, post-indexing by either 
adding or subtracting the contents of ARO, single indirect addressing with no increment or decrement, 
and bit-reversal addressing (used in FFTs) with increment or decrement. All operations are performed on 
the current auxiliary register in the same cycle as the original instruction, followed by a new ARP value 
being loaded. | 


repeat feature 


A repeat feature, used with instructions such as multiply/accumulates, block moves, |/O transfers, and 
table read/writes, allows a single instruction to be performed up to 256 times. The repeat counter (RPTC) 
is loaded with either a data memory value (RPT instruction) or an immediate value (RPTK instruction). The 
value of this operand is one less than the number of times that the next instruction is executed. Those 
instructions that are normally multicycle are pipelined when using the repeat feature, and effectively become 
single-cycle instructions. 


instruction set summary 


Table 1 lists the symbols and abbreviations used in Table 2, the instruction set summary. Table 2 consists 
primarily of single-cycle, single-word instructions. Infrequently used branch, I/O, and CALL instructions 
are multicycle. The instruction set summary is arranged according to function and alphabetized within each 
functional grouping. The symbol (t) indicates those instructions that are not included in the TMS32010 
instruction set. The symbol (+) indicates instructions that are not included in the TMS32020 instruction set. 
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TABLE 1. INSTRUCTION SYMBOLS 


symBou | MEANING 


4-bit field specifying a bit code 

2-bit field specifying compare mode 

Data memory address field 

Format status bit 

Addressing mode bit 

Immediate operand field 

Port address (PAO through PA15 are predefined 
assembler symbols equal to O through 15, respectively.) 
2-bit field specifying P register output shift code 


3-bit operand field specifying auxiliary register 
4-bit left-shift code 
3-bit accumulator left-shift field 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY 


ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS 





MNEMONIC 


tThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 


DESCRIPTION 


Absolute value of accumulator 

Add to accumulator with shift 

Add to accumulator with carry 

Add to high accumulator 

Add to accumulator short immediate 

Add to low accumulator with sign 

extension suppressed 

Add to accumulator with shift specified by 

T register 

Add to accumulator long immediate with shift 
AND with accumulator 

AND immediate with accumulator with shift 
Complement accumulator 

Load accumulator with shift 

Load accumulator immediate short 

Load accumulator with shift specified by T register 
Load accumulator long immediate with shift 
Negate accumulator 

Normalize contents of accumulator 

OR with accumulator 

OR immediate with accumulator with shift 
Rotate accumulator left 

Rotate accumulator right 

Store high accumulator with shift 

Store low accumulator with shift 

Subtract from accumulator long immediate with shift 
Shift accumulator left 


Shift accumulator right 


Subtract from accumulator with shift 

Subtract from accumulator with borrow 
Conditional subtract 

Subtract from high accumulator 

Subtract from accumulator short immediate 
Subtract from low accumulator with sign 
extension suppressed 

Subtract from accumulator with shift specified by 
T register 

Exclusive-OR with accumulator 

Exclusive-OR immediate with accumulator with shift 
Zero accumulator 

Zero low accumulator and load high accumulator 
Zero low accumulator and load high accumulator 
with rounding 

Zero accumulator and load low accumulator with 
sign extension suppressed 


NO. 


2 
1 
2 
1 
1 
1 
1 
2 
1 
1 
1 
2 
1 
1 
1 
1 
2 
1 
1 
1 
1 
1 
1 
1 
1 


INSTRUCTION BIT CODE 


1514131211109 8765 43 210 


CO0CO0O0O0O0oOOoOH-=-c00 cA 0OOaOOOHaA0c 0 OO 
CO0O0OO=0c0OH-c0O0COOH-aoaOOoOsH-0c0OOO=A0 = 
----o00--000-=+00- 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONTINUED) 





MNEMONIC 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


DESCRIPTION 





NO. 
WORDS 


INSTRUCTION BIT CODE 


1514131211109 8 765 43 21 0 





ADRK Add to auxiliary register short immediate 1 O1141 11 10<«——K—> 
CcmpRt Compare auxiliary register with auxiliary register ARO 1 11001411001 01 0 0<CMP> 
LAR Load auxiliary register 1 00110 -R—~ | <«———)—— > 
LARK Load auxiliary register short immediate 1 1 10 .0-0 A ee ————— Kh 
LARP Load auxiliary register pointer 1 0101031011000 1 <@-R-> 
LDP Load data memory page pointer 1 01010010 | <«&——D—> 
LDPK Load data memory page pointer immediate 1 11003100 <«—\—DP———r 
LRLKt Load auxiliary register long immediate 2 11010 ~@RY 000000 0 0 
MAR Modify auxiliary register 1 01010101 1 @——D——-——>r 
SAR Store auxiliary register 1 O1%1%10~<«#R~> | <——D)D— 
SBRK* Subtract from auxiliary register short immediate 1 O11%171%1%111—K—— > 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 





MNEMONIC 


DESCRIPTION 





2 
© 


WORDS 


INSTRUCTION BIT CODE 





1514131211109 8765 43210 
1 


APAC Add P register to accumulator 1 11003141 1000010 1 0 
LPHT Load high P register 1 01010 ee 
LT Load T register 1 001114 100i «——D-—> 
LTA Load T register and accumulate previous product 1 00111101 1*——D—-——~ 
LTD Load T register, accumulate previous product, 1 00114111110 =—-—-—Dd-—> 
and move data 

LTpt Load T register and store P register in accumulator 1 001131%1%10/| ——D-—_——> 
LTst Load T register and subtract previous product 1 01011014 1 1 «——D——> 
MAct Multiply and accumulate 2 01011101 1 <———D——»> 
MACDt Multiply and accumulate with data move 2 010%1%1°100it #———D—-———> 
MPY Multiply (with T register, store product in P register) 1 00111000 <«——D——> 
MPYA+ Multiply and accumulate previous product 1 0011101 0/1 @«——D—> 
MPYK Multiply immediate 1 QQ Oe ———— Oe OOOO 
mpyst Multiply and subtract previous product 1 0011%10314ii1'%+80@C}——D-—-—> 
MPYU* Multiply unsigned 1 1100311114 1 —<$———DpD—» 
PAC Load accumulator with P register 1 11003141 1000081i0 10 0 
SPAC Subtract P register from accumulator 1 1100114100001 014 1 0 
SPH*+ Store high P register 1 01117411011 «——D—— > 
SPL? Store low P register 1 011111001 <«<—)D——-»> 
spmt Set P register output shift mode 1 1100111000001 0<PM> 
sarRAt Square and accumulate 1 00111001 | <«——\D—— > 
sarst Square and subtract previous product 1 010110e3104+*-——D—_-—> 


TThese instructions are not included in the TMS32010 instruction set. 
+These instructions are not included in the TMS32020 instruction set. 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONTINUED) 






BRANCH/CALL INSTRUCTIONS 


NO. INSTRUCTION BIT CODE _ 





MNEMONIC ~ DESCRIPTION | ae 
. WORDS ————— 

- 1514131211109 8 765 43 21 0 
B Branch unconditionally © ng 1731373131131 ——D)D-—-——> 
BACctT Branch to address specified by accumulator 1 1710031110001 00710 1 
BANZ Branch on auxiliary register not zero 2 1171741103411 «#—_—_.—»> 
BBNz‘ Branch if TC bit # O 2 117111003114 <«<——D——> 
BBzt Branch if TC bit = O 2 11131310001 #«——D)D-———> 
Bct Branch on carry 2 0101%1%1%10%1 <«——\)—> 
BGEZ Branch if accumulator > O 2 111101001 <——p——-» 
BGZ Branch if accumulator > O 2 LD PD OOO) Di 
BIOZ Branch on |/O status = O 2 1171317131 3131%0e%10%1 <—D——> 
BLEZ Branch if accumulator < O 2 111171001310 1e—)D—> 
BLZ Branch if accumulator < O 2 1713131008111 @—-D——> 
BNC# Branch on no carry 2 01011 1 1 1 1 ¢«——D—-——>r 
BNVt Branch if no overflow 2 171314317 0%7131 1 «+ —D————Pr 
BNZ Branch if accumulator # O 2 11143103140311——D)D-—_——> 
BV Branch on overflow 2 111100001 <«——D———> 
BZ Branch if accumulator = O 2 1 3h OP Oe eh Oo): = 
CALA Call subroutine indirect 1 1100311 1000100 1 0 0 
CALL Call subroutine 2 1117441113101 &—D-—_—> 
RET Return from subroutine 1 1100141 10e00810071 1 0 





I/O AND DATA MEMORY OPERATIONS 








NO. INSTRUCTION BIT CODE 
MNEMONIC — DESCRIPTION 

WORDS 

1514131211109 8765 43 210 

BLKD Block move from data memory to data memory 2 1711717111011 eD——> 
BLKPT _ Block move from program memory to data memory 2 17317114 1 100id+28iC———-D 
DMOV Data move in data memory 1 0 T.0.7 O11 On Se ———)—— SF 
FORTT Format serial port registers 1 1100111000001 1 1F0 
IN Input data from port 1 1000 <«—PA—> | <——D)D——~ 
OUT Output data to port 1 Lt od 0 AS 1 A 
RFSM+ Reset serial port frame synchronization mode 1 1100314110008 10 1 1 0 
RTXmMt Reset serial port transmit mode 1 1100313110001 000 0 0 
RXFt Reset external flag 1 1100111000001100 
SFSM# Set serial port frame synchronization mode 1 1100131100031 10 1 1=1 
STXMt Set serial port transmit mode 1 1100111000100001 
SXFT Set external flag 1 1100111000001 1 0 1 
TBLR Table read 1 010110001 «——D—— > 
TBLW Table write 1 01011001 1 «#——p——-> 


TThese instructions are not included in the TMS32010 instruction set. 
tThese instructions are not included in the TMS32020 instruction set. 
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TABLE 2. TMS320C25 INSTRUCTION SET SUMMARY (CONCLUDED) 





CONTROL INSTRUCTIONS 





1514131211109 8765 43210 








BIT Test bit 1 100%1~<«+—e-—-> | <——)D— > 
BiTTT Test bit specified by T register 1 0101031411 4 <«———\——» 
CNFDt Configure block as data memory 1 11003141 100000010 0 
CNFPT Configure block as program memory 1 1100141 1000000810 1 
DINT Disable interrupt 1 110031341 10e000000041 
EINT Enable interrupt 1 1100313141 10e00000000 
IDLET idle until interrupt 1 11003134%131000081 14 141 «41 ~=«'1 
LST Load status register STO 1 010100001. #——D—-—_> 
LsT1T Load status register ST1 1 0101000114 #——_D)D-—_~> 
NOP No operation 1 01010310313 0000000 O 
POP Pop top of stack to low accumulator 1 110031314 10e0008138 1 0 = 1 
Poppt Pop top of stack to data memory 1 011311%0310t4|t~~”—_D)D-—_—_> 
PSHDt Push data memory value onto stack 1 010101 00(e——-———_0-—_—_—_—> 
PUSH Push low accumulator onto stack 1 110011 1000084184 10 0 
Rc# Reset carry bit 1 1100111000110000 
RHM?+ Reset hold mode 1 11001110001%1%1000 
ROVM Reset overflow mode 1 1100e1%1%10e00000010 
RPTT Repeat instruction as specified by data memory value 1 01:001011tsts>—D-—> 
RPTKT Repeat instruction as specified by immediate value 1 11001011 -————K——— > 
RSxmt Reset sign-extension mode 1 11001141 1000000411 0 
RTCt Reset test/control flag 1 1100131313110003110010 
sct Set carry bit 1 1100111000311000 1 
SHM# Set hold mode 1 110011100011 100 1 
SOVM Set overflow mode 1 1100141 10000000 1 +41 
SST Store status register STO 1 011110001 —D)D-———> 
ssTit Store status register ST1 1 01111001 1 «——\)—— >» 
SSXMT Set sign-extension mode 1 1100141 100000071781 «4 
stTct Set test/control flag 1 1100111000110011' 
TRAPT Software interrupt 1 1100111000011 1410 
tThese instructions are not included in the TMS32010 instruction set. 

+These instructions are not included in the TMS32020 instruction set. 
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development systems and: software support 


Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS320C25-based microprocessor system. When developing an application, tools are provided to 
evaluate the performance of the processor, to develop the algorithm implementation, and to fully integrate 
the design’s software and hardware modules. When questions arise, additional support can be obtained 
by calling the nearest Texas Instruments Regional Technology Center (RTC). | 


Sophisticated development operations are performed with the TMS320C25 Macro Assembler/Linker, 
Simulator, and Emulator (XDS). The macro assembler and linker are used to translate program modules 
into object code and link them together. This puts the program modules into a form which can be loaded 
into the TMS320C25 Simulator or Emulator. The simulator provides a quick means for initially debugging 
TMS320C25 software while the emulator provides the real-time in-circuit emulation necessary to perform 
system level debug efficiently. | 


Table 3 gives a complete list of TMS320C25 software and hardware development tools. 


TABLE 3. TMS320C25 SOFTWARE AND HARDWARE SUPPORT 


MACRO ASSEMBLERS/LINKERS 












VMS 





EMULATORS 
ode aaeceann 
XDS/22 | Included TMDS3262221 
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absolute maximum ratings over specified temperature range (unless otherwise noted) tf 


Supply voltage range, VCCT .. 1... ee eee eee -0.3 Vto7V 
Input VOILAGe (ange: 4.6405 4 sw wed SESE Ae Eee ee whee se 1 eee -O.3 Vto7V 
Output voltage ranges oe 44 Sows PES EERE GEE SEA SESE SRR SE EES -O0.3Vto 7V 
Continuous power dissipation ... 2... 0.0.00. ce ee ee ee ee eee 1.5 W 
Operating free-air temperature range ...... 0... 0.0. ce ee ee ee 0°C to 70°C 
Storage temperature range ...... 0.0.0. cc ee ee eee -55°C to 150°C 


TStresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

+All voltage values are with respect to Vss:. 


recommended operating conditions 


Voc Supply voltage 45s S| 
¥ss Supply voltage ed 


All inputs except CLKIN 2 Vcc +0.3 V 
Vin hianlevetinpucwvoreae cc+03 | Vv 
CLKIN 2.4 Voc +0.3 

V 
IL 


V i euevarinouraaltauc All inputs except CLKIN —0.3 0.8 
vel input v 
a E a CLKIN -03 0.8 


IOH High-level output current 300 
lo. Low-level output current 
TA Operating free-air temperature 0 70 




























Voc = MIN, lo. = MAX 03 06 

=20 20 

“10 10 

"icc Supply current =~ TA = 0°C, Vcc = MAX y= MAX ——SSS~*BO 

0 DS 
; a EE 


C Output capacitance 


TAI! typical values are at Vec = 5V, Ta = 25°C. 





«& Caution. This device contains circuits to protect its inputs and outputs against damage due to high static voltages or electrostatic 
Ava fields. These circuits have been qualified to protect this device against electrostatic discharges (ESD) of up to 2 kV according 
to MIL-STD-883C, Method 3015; however, it is advised that precautions be taken to avoid application of any voltage higher than maximum 
rated voltages to these high-impedance circuits. During storage or handling, the device leads should be shorted together or the device 
should be placed in conductive foam. In a circuit, unused inputs should always be connected to an appropriate logic voltage level, preferrably 
either Vcc or ground. Specific guidelines for handling devices of this type are contained in the publication ‘‘Guidelines for Handling Electrostatic- 
Discharge Sensitive (ESDS) Devices and Assemblies’’ available from Texas Instruments. 
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CLOCK CHARACTERISTICS AND TIMING 


The TMS320C25 can use either its internal oscillator or an external frequency source for a clock. 


internal clock option 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 2). The 
frequency of CLKOUT1 is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. | | 
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FIGURE 2. INTERNAL CLOCK OPTION 
external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X11 left 
unconnected. The external frequency injected must conform to the specifications listed in the following table. 


switching characteristics over recommended operating conditions (see Note 1) 


PARAMETER 
te(C) CLKOUT1/CLKOUT2 cycle time 


td(CIH-c) | CLKIN high to CLKOUT1/CLKOUT2/STRB high/low 
tfc) CLKOUT 1/CLKOUT2/STRB fall time 


tr(C) ~ CLKOUT1/CLKOUT2/STRB rise time 


tw(CL) CLKOUT1/CLKOUT2 low pulse duration 20-8 20 20+8 


twi(CH) CLKOUT1/CLKOUT2 high pulse duration 20-8  2Q 20+8 
td(C1-C2) CLKOUT1 high to CLKOUT2 low, CLKOUT2 high to CLKOUT1 high, etc. 





NOTE 1:Q = 1/4t.(¢). 
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timing requirements over recommended operating conditions (see Note 1) 


te(Cl) CLKIN cycle time 
tt(Cl) CLKIN fall time 
triCl) CLKIN rise time 


tw(CIL) CLKIN low pulse duration, tc(cj) = 50 ns (Note 2) 
tw(CIH) CLKIN high pulse duration, tg(cj) = 50 ns (Note 2) 


tsu(S) SYNC setup time before CKLIN low 
th(S) SYNC hold time from CLKIN low 





NOTES: 1.Q = 1/4t,(c). 
2. CLKIN duty cycle [tr(cj) + tw(CIH)]/te(cl) Must be within 40-60%. 
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clock timing 
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MEMORY AND PERIPHERAL INTERFACE TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


PARAMETER MIN TYP MAX 
ta(C1-S) STRB from CLKOUT1 (if STRB is present) Q-8 Q Q+8 


tsu(A) Address setup time before STRB low (Note 3) fO-15 
thia) Address hold time after STRB high (Note 3) | a-8 | 


tw(SL) STRB low pulse duration (no wait states, Note 4) 


[ons 
pons 
pons 
| ns | 
pons 
tw(SH) STRB high pulse duration (between consecutive cycles, Note 4) PQs os 
pons 
pons | 
pons 
[ons 

















tgu(D)W Data write setup time before STRB high (no wait states) 
Sse 20 
tno) Data bus starts being driven after STRE low (wits oye) ———SOS~=~idSC‘i 


NOTES: 1.Q = 1/4tg(c). 
3. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address."’ 
4. Delays between CLKOUT 1/CLKOUT2 edges and STRB edges track each other, resulting in tw(SL) and tw(SH) being 20 with 
no wait states. | 


timing requirements over recommended operating conditions (see Note 1) 


ta(A) Read data access time from address time (read cycle, Notes 3 and 5) | 30-35 


tsu(D)R Data read setup time before STRB high 
thiD)R Data read hold time from STRB high Oo. 


~ td(SL-R) READY valid after STRB low (no wait states) P20] ons 
tdiC2H-R) READY valid after CLKOUT2 high poe. Oe ae 









th(SL-R) READY hold time after STRB low (no wait states) ee ee 
th(C2H-R) READY hold after CLKOUT2 high 


Q-2 
td(M-R) READY valid after MSC valid | 20-25 
th(M-R) READY hold time after MSC valid LO 


NOTES: 1.Q = 1/4tg(c). 
3. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.”’ 
5. Read data access time is defined as ta(A) = tsyu(A) + tw(SL) — tsu(D)R- 
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memory read timing | 
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one wait-state memory access timing 
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RS, INT, BIO, and XF TIMING — 





switching characteristics over recommended operating conditions (see Note 1) 


| 22 
. 0 12 
Q 






td(RS) CLKOUT1 low to reset state entered | Pee OR nee | 
td(XF _XF valid before falling edge of STRB ee ee 


NOTES: 1.Q = 1/4t¢(¢). 
.6. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup 
time is met, the exact sequence shown in the timing diagrams will occur. 






timing requirements over recommended operating conditions (see Note 1) 
N NOM MAX 
tsu(IN) °_ INT/BIO/RS setup before CLKOUT1 high a | 


th(IN) INT/BIO/RS hold after CLKOUT1 high 
0 


te (IN) INT/BI 


fall time | 


MI 

2 
twin) __INT/BIO low pulse duration oe ae: 
twiRs) RS low pulse duration 


NOTES: 1.Q = 1/4tgic). | | | 
6. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup time 
is met, the exact sequence shown in the timing diagrams will occur. 





reset timing 
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KKK 


PACK QD ESR, 


SERIAL PORT XXX 090955090905 99 iii 
CONTROLS? KXXXXXRRXXKKKKR KKK KKK RAR Y 


tContro! signals are DS, 1S, R/W and XF. 
Serial port controls are DX and FSX. 
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interrupt timing 
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external flag timing 
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HOLD TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


[tenia.ciu) Adare crven before CLKOUT ow OLB mode, wows) ——SSCSC*iSC(“‘“‘“‘“‘~*S 


NOTES: 1.0 = 1/4te(c). 
3. A15-AO, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.”’ 












timing requirements over recommended operating conditions (see Note 1) 


NOTE: 1.Q = 1/4tg(c). 





HOLD timing (part A) 
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HOLD timing (part B) 
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SERIAL PORT TIMING 


switching characteristics over recommended operating conditions (see Note 1) 


taiCH-Dx) DX valid after CLKX rising edge (Noe 7) ——SCS~C~—~—~“s~S*~*~“~C~rCS~SO ts 
Ttatpt.Dx) DX valid after FSX falling edge (TXM = 0, Note 7) SSCS 
[ta\Crers) FSX vald ater CLK ving edge XM = YP 


NOTES: 1.Q = 1/4tg(c). 
7. The last occurrence of FSX falling and CLKX rising. 






timing requirements over recommended operating conditions (see Note 1) 


a 
twiSck) Serial port clock (CLKX/GLKR) low pulse duration Gee Nowe 6) | OC 
[twiSck) Serial port clock (CLKX/GLKRI high pulse durstion (see Note 8 ——S«dT iO SSC~*” 
3 a 

3 

: 










tsu(FS) FSX/FSR setup time before (CLKX/CLKR) falling edge (TXM = OQ) 10 
th(FS) FSX/FSR hold time after (CLKX/CLKR) falling edge (TXM = OQ) 
tsu(DR) DR setup time before CLKR falling edge 


th(DR) DR hold time after CLKR falling edge 


NOTES: 1. Q = 1/4tgc). 
8. The duty cycle of the serial port clock must be within 40-60%. 


serial port receive timing 
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| ¢ 
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| | 1 | ; | 
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serial port transmit timing 
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(MECHANICAL DATA 


68-pin plastic leaded chip carrier package 


THERMAL RESISTANCE CHARACTERISTICS 


PARAMETER | MAX | UNIT 
Junction-to-free-air 
R °C/W 
JA thermal resistance 46 | ecw 
Junction-to-case 
R °C/W 
GC thermal resistance pa | eorw 



















25,27 (0.995) | 
4 -968) 


1,14 (0.045) X 45° 














- 4,78 (0.188) NOM 
4,06 cs eaia sae 24,28 (0.956) 
(0.95 
O° a3 (0. ‘63 10-028) 25,27 (0.995) 


1,27 (0. Oa X 45° 24,59 (0.968) 


2,41 (0.095) MIN 





St 





~ 23,62 (0.930) 
¥ 33,32 (0.918) 


1,35 (0.053) 
7,19 (0.047) 
0,81 (0.032) 
0,66 (0.026) 
0,46 (0.018) 
0,36 (0.014) 
3°-nom| — — | (TOAQRURUS UGG Je ele alin int ial inl inl 
-e1— 1,52 (0.060) MIN mite 0,25 (0.010) R 
3° NOM | ae MAX 


_ ALL LINEAR DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES — 
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200-ns Instruction Cycle Time 


544 Words of Programmable On-Chip Data 
RAM 


128K Words of Data/Program Space 


Sixteen Input and Sixteen Output Channels 


16-Bit Parallel Interface 


Directly Accessible External Data Memory 
Space 


Global Data Memory Interface 
16-Bit Instruction and Data Words 
32-Bit ALU and Accumulator 


Single-Cycle Multiply/Accumulate 
Instructions 


O to 16-Bit Scaling Shifter 


Bit Manipulation and Logical Instructions 


@ Instruction Set Support for Floating-Point 
Operations 


@ Block Moves for Data/Program Management 


PIN ASSIGNMENTS 


CLKOUT1 
D4 
D3 
CLKOUT2 


SYNC 


FSX 
X2/CLKIN 





PRODUCTION DATA documents contain information 
current as of publication date. Products conform 
to specifications per the terms of Texas Instruments 
standard warranty. Production processing does not 
necessarily include testing of all parameters. 
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Repeat Instructions for Efficient Use of 
Program Space 


Five Auxiliary Registers and Dedicated 
Arithmetic Unit for Indirect Addressing 


Serial Port for Direct Codec Interface 


Synchronization Input for Synchronous 
Multiprocessor Configurations 


Wait States for Communication to Slow 
Off-Chip Memories/Peripherals 


On-Chip Timer for Control Operations 
Three External Maskable User Interrupts 


Input Pin Polled by Software Branch 
Instruction 


Programmable Output Pin for Signalling 
External Devices 


2.4-Micron NMOS Technology 
Single 5-V Supply 
On-Chip Clock Generator 


68-PIN GB 
PIN GRID ARRAY CERAMIC PACKAGE! 
(TOP VIEW) 


123 4 5 6 7 8 9 10 11 





tT See Pin Assignments Table (Page 1) and Pin Nomenclature Table 
(Page 2) for location and description of all pins. 
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PIN NOMENCLATURE 


| NAME — | Wo/zt 7 DEFINITION _ | | 


Vcc 


Vss 
KT. 


X2/CLKIN 
CLKOUT1 








5-V supply pins 
Ground pins 

























Output from internal oscillator for crystal 

Input to internal oscillator from crystal or external clock 

Master clock output (crystal or CLKIN frequency/4) 

A second clock output signal - 

16-bit data bus 015 (MSB) through DO (LSB). Multiplexed between program, data, and 1/O 
spaces. | ; | 

16-bit address bus A15 (MSB) through AO (LSB) 

Program, data, and I/O space select signals 

Read/write signal 

Strobe signal 

Reset input 

External user interrupt inputs 

Microstate complete signal 

Interrupt acknowledge signal 

Data ready input. Asserted by external logic when using slower devices to indicate that the 
Current bus transaction is complete. | 

Bus request signal. Asserted when the TMS32020 requires access to an external global data 





memory space. 
External flag output (latched software-programmable signal). 

Hold input. When asserted, TMS32020 goes into an idle mode and puts the data, address, and 
control lines in the high-impedance state. 

Hold acknowledge signal 

Clock synchronization input 

Branch control input. Polled by BIOZ instruction. 

Serial data receive input 

Clock for receive input for serial port 

Frame synchronization pulse for receive input 

Serial data transmit output 

Clock for transmit output for serial port 

Frame synchronization pulse for transmit. Configurable as either an input or an output. 


t1/O/Z = Input/Output/High-impedance state. | 
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functional block diagram 
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description | | 


The TMS32020 Digital Signal Processor is the second member of the TMS320 family of VLSI digital signal 
processors and peripherals. The TMS320 family supports a wide range of digital signal processing 
applications, such as telecommunications, modems, image processing, speech processing, spectrum 
analysis, audio processing, digital filtering, high-speed control, graphics, and other computation-intensive 
applications. 


With a 200-ns instruction cycle time and an innovative memory configuration, the TMS32020 performs 
operations necessary for many real-time digital signal processing algorithms. Since most instructions require 
only one cycle, the TMS32020 is capable of executing five million instructions per second. On-chip data 
RAM of 544 16-bit words, direct addressing of up to 64K words of external data memory space and 64K 
words of external program memory space, and multiprocessor interface features for sharing global memory 
minimize unnecessary data transfers to take full advantage of the capabilities of the processor. 


architecture 


The TMS32020 architecture is based upon that of the TMS32010, the first member of the TMS320 family. 
The TMS32020 increases performance of DSP algorithms through innovative additions to the TMS320 
family architecture. TMS32010 source code is upward-compatible with TMS32020 source code and can 
be assembled using the TMS32020 Macro Assembler. | 


Increased throughput on the TMS32020 for many DSP applications is accomplished by means of single- 
cycle multiply/accumulate instructions with a data move option, five auxiliary registers with a dedicated 
arithmetic unit, and faster I/O necessary for data-intensive signal processing. 


The architectural design of the TMS32020 emphasizes overall speed, communication, and flexibility in 
processor configuration. Control signals and instructions provide floating-point support, block-memory 
transfers, communication to slower off-chip devices, and multiprocessing implementations. 


Two large on-chip RAM blocks, configurable either as separate program and data spaces or as two 
contiguous data blocks, provide increased flexibility in system design. Maintaining program memory off- 
chip allows large address spaces from which large programs of up to 64K words can operate at full speed. 
Programs can also be downloaded from slow external memory to high-speed on-chip RAM. A total of 64K 
data memory address space is included to facilitate implementation of DSP algorithms. The VLSI 
implementation of the TMS32020 incorporates all of these features as well as many others, such as a 
hardware timer, serial port, and block data transfer capabilities. 


32- bit ALU/accumulator 


The TMS32020 32-bit Arithmetic Logic Unit (ALU) and accumulator perform a wide range of arithmetic 
and logical instructions, the majority of which execute in a single clock cycle. The ALU executes a variety 
of branch instructions dependent on the status of the ALU or a single bit in a word. These instructions 
provide the following capabilities: 


e Branch to an address specified by the accumulator 
e Normalize fixed-point numbers contained in the accumulator 
e Test a specified bit of a word in data memory. 


One input to the ALU is always provided from the accumulator, and the other input may be provided from 
the Product Register (PR) of the multiplier or the input scaling shifter which has fetched data from the 
RAM on the data bus. After the ALU has performed the arithmetic or logical operations, the result is stored 
in the accumulator. | | 


The 32-bit accumulator is split into two 16-bit segments for storage in data memory. Additional shifters 
at the output of the accumulator perform shifts while the data is being transferred to the eae bus for 
storage. The contents of the accumulator remain unchanged. 
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scaling shifter 


The TMS32020 scaling shifter has a 16-bit input connected to the data bus and a 32-bit output connected 
to the ALU. The scaling shifter produces a left shift of O to 16 bits on the input data, as programmed 
in the instruction. The LSBs of the output are filled with zeroes, and the MSBs may be either filled with 
zeroes or sign-extended, depending upon the status programmed into the SXM (sign-extension mode) bit 
of status register STO. 


16 x 16-bit parallel multiplier 


The TMS32020 has a two’s complement 16 x 16-bit hardware multiplier, which is capable of computing 
a 32-bit product in a single machine cycle. The multiplier has the following two associated registers: 


e A 16-bit Temporary Register (TR) that holds one of the operands for the multiplier, and 
e A 32-bit Product Register (PR) that holds the product. 


Incorporated into the TMS32020 instruction set are single-cycle multiply/accumulate instructions that allow 
both operands to be processed simultaneously. The data for these operations resides in the on-chip RAM 
blocks and can be transferred to the multiplier each cycle via the program and data buses. 


Four product shift modes are available at the Product Register (PR) output that are useful when performing 
multiply/accumulate operations, fractional arithmetic, or justifying fractional products. 


timer 


The TMS32020 provides a memory-mapped 16-bit timer for control operations. The on-chip timer (TIM) 
register is a down counter that is continuously clocked by an internal clock. This clock is derived by dividing 
the CLKOUT1 frequency by 4. A timer interrupt (TINT) is generated every time the timer decrements to 
zero. The timer is reloaded with the value contained in the period (PRD) register within the same cycle 
that it reaches zero so that interrupts may be programmed to occur at regular intervals of 4 x (PRD) 
cycles of CLKOUT1. 


memory control 


The TMS32020 provides a total of 544 16-bit words of on-chip data RAM, divided into three separate 
blocks (BO, B1, and B2). Of the 544 words, 288 words (blocks B1 and B2) are always data memory, and 
256 words (block BO) are programmable as either data or program memory. A data memory size of 544 
words allows the TMS32020 to handle a data array of 512 words (256 words if on-chip RAM is used 
for program memory), while still leaving 32 locations for intermediate storage. When using block BO as 
program memory, instructions can be downloaded from external program memory into on-chip RAM and 
then executed. 


When using on-chip program RAM or high-speed external program memory, the TMS32020 runs at full 
speed without wait states. However, the READY line can be used to interface the TMS32020 to slower, 
less-expensive external memory. Downloading programs from slow off-chip memory to on-chip program 
RAM speeds processing while cutting system costs. 


The TMS32020 provides three separate address spaces for program memory, data memory, and I/O. The 
on-chip memory is mapped into either the 64K-word data memory or program memory space, depending 
upon the memory configuration. The CNFD (configure block BO as data memory) and CNFP (configure 
block BO as program memory) instructions allow dynamic configuration of the memory maps through 
software. Regardless of the configuration, the user may still execute from external program memory. 


The TMS32020 has six registers that are mapped into the data memory space: a serial port data receive 
register, serial port data transmit register, timer register, period register, interrupt mask register, and global 
memory allocation register. 
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(EXTERNAL) | REGISTERS 
31(>001F) 5(>0005) 15 
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(b) ADDRESS MAPS AFTER A CNFP INSTRUCTION © 
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BLOCK BO 





65,535(>FFFF) 65,535(>FFFF) 


FIGURE 1. MEMORY MAPS 
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interrupts and subroutines 


The TMS32020 has three external maskable user interrupts INT2-INTO, available for external devices that 
interrupt the processor. Internal interrupts are generated by the serial port (RINT and XINT), by the timer 
(TINT), and by the software interrupt (TRAP) instruction. Interrupts are prioritized with reset (RS) having 
the highest priority and the serial port transmit interrupt (XINT) having the lowest priority. All interrupt 
locations are on two-word boundaries so that branch instructions can be accommodated in those locations 
if desired. 


A built-in mechanism protects multicycle instructions from interrupts. If an interrupt occurs during a 
multicycle instruction, the interrupt is not processed until the instruction is completed. This mechanism 
applies both to instructions that are repeated or become multicycle due to the READY signal. 


external interface 


The TMS32020 supports a wide range of system interfacing requirements. Program, data, and I/O address 
spaces provide interface to memory and I/O, thus maximizing system throughput. I/O design is simplified 
by having I/O treated the same way as memory. I/O devices are mapped into the I/O address space using 
the processor's external address and data busses in the same manner as memory-mapped devices. Interface 
to memory and I/O devices of varying speeds is accomplished by using the READY line. When transactions 
are made with slower devices, the TMS32020 processor waits until the other device completes its function 
and signals the processor via the READY line. Then, theTMS32020 continues execution. 


A serial port provides communication with serial devices, such as codecs, serial A/D converters, and other 
serial systems. The interface signals are compatible with codecs and many other serial devices with a 
minimum of external hardware. The serial port may also be used for intercommunication between processors 
in multiprocessing applications. 


The serial port has two memory-mapped registers: the data transmit register (DXR) and the data receive 
register (DRR). Both registers operate in either the byte mode or 16-bit word mode, and may be accessed 
in the same manner as any other data memory location. Each register has an external clock, a framing 
synchronization pulse, and associated shift registers. One method of multiprocessing may be implemented 
by programming one device to transmit while the others are in the receive mode. 


multiprocessing 


The flexibility of the TMS32020 allows configurations to satisfy a wide range of system requirements. 
The TMS32020 can be used as follows: 


e A standalone processor 

e A multiprocessor with devices in parallel 

e A slave/host multiprocessor with global memory space 

e A peripheral processor interfaced via processor-controlled signals to another device. 


For multiprocessing applications, the TMS32020 has the capability of allocating global data memory space 
and communicating with that space via the BR (bus request) and READY control signals. Global memory 
is data memory shared by more than one processor. Global data memory access must be arbitrated. The 
8-bit memory-mapped GREG (global memory allocation register) specifies part of the TMS32020’s data 
memory as global external memory. The contents of the register determine the size of the global memory 
space. If the current instruction addresses an operand within that space, BR is asserted to request control 
of the bus. The length of the memory cycle is controlled by the READY line. 


The TMS32020 supports DMA (direct memory access) to its external program/data memory using the HOLD 
and HOLDA signals. Another processor can take complete control of the TMS32020’s external memory 
by asserting HOLD low. This causes the TMS32020 to place its address, data, and control lines in a 
high-impedance state and assert HOLDA. 





j 
TEXAS 4 
INSTRUMENTS 


POST OFFICE BOX 1443 @® HOUSTON. TEXAS 77001 


B-7 


™MS32020 
DIGITAL SIGNAL PROCESSOR 





instruction set 


The TMS32020 microprocessor implements a comprehensive instruction set that supports both numeric- 
_ intensive signal processing operations as well as general-purpose applications, such as multiprocessing 
and high-speed control. The TMS32010 source code is upward-compatible with TMS32020 source code. 


For maximum throughput, the next instruction is prefetched while the current one is being executed. Since 
the same data lines are used to communicate to external data/program or I/O space, the number of cycles 
may vary depending upon whether the next data operand fetch is from internal or external program memory. 
Highest throughput is achieved by maintaining data memory on-chip and using either internal or fast external 
program memory. 


addressing modes 


The TMS32020 instruction set provides three memory addressing modes: direct, indirect, and immediate 
addressing. 


Both direct and indirect addressing can be used to access data memory. In direct addressing, seven bits 
of the instruction word are concatenated with the nine bits of the data memory page pointer to form the 
16-bit data memory address. Indirect addressing accesses data memory through the five auxiliary registers. 
In immediate addressing, the data is based on a portion of the instruction word(s). 


In direct memory addressing, the instruction word contains the lower seven bits of the data memory address. 
This field is concatenated with the nine bits of the data memory page pointer to form the full 16-bit address. 
Thus, memory is paged in the direct addressing mode with a total of 512 pages, each page containing 
128 words. 


Five auxiliary registers (ARO- AR4) provide flexible and powerful indirect addressing. To select a specific 
auxiliary register, the Auxiliary Register Pointer (ARP) is loaded’ with either a O, 1, 2, 3, or a 4 for ARO 
through AR4, respectively. 


There are five types of indirect addressing: auto-increment or auto-decrement, post-indexing by either adding 
or subtracting the contents of ARO, or single indirect addressing with no increment or decrement. All 
operations are performed on the current. auxiliary register in the same cycle as the original instruction, 
followed by a new ARP value being loaded. 


repeat feature 


A repeat feature, used with instructions such as multiply/accumulates, block moves, I/O transfers, and 
table read/writes, allows a single instruction to be performed up to 256 times. The repeat counter (RPTC) 
is loaded with either a data memory value (RPT instruction) or an immediate value (RPTK instruction). The 
value of this operand is one less than the number of times that the next instruction is executed. Those 
instructions that are normally multicycle: are eipipemed when using the repeat feature, and effectively become 
single-cycle instructions. 


instruction set summary 


_ Table 1 lists the symbols and abbreviations used in Table 2, the instruction set summary. Table 2 consists 
primarily of single-cycle, single-word instructions. Infrequently used branch, I/O, and CALL instructions 
are multicycle. The instruction set summary is arranged according to function and alphabetized within each 
functional grouping. The symbol (ft) indicates those instructions that are not included in the TMS32010 
instruction set. 
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TABLE 1. INSTRUCTION SYMBOLS 


SYMBOL MEANING 


4-bit field specifying a bit code 
2-bit field specifying compare mode 

Data memory address field 

Format status bit 

Addressing mode bit 

Immediate operand field 

Port address (PAO through PA15 are predefined 
assembler symbols equal to 0 through 15, 
respectively.) 

2-bit field specifying P register output shift 
code 

3-bit operand field specifying auxiliary register 
4-bit left-shift code 

3-bit accumulator left-shift field 
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TABLE 2. INSTRUCTION SET SUMMARY © 
ACCUMULATOR MEMORY REFERENCE INSTRUCTIONS : 









Mnemonic Description a 7 7 “Instruction Bit Code 


4131211109 8765 43 21 

0111 000.01 1011 
0——S,——> | + D ————— 
0100 0 |[————D——+ 
010014 |———)D—— 


Absolute value of accumulator 
Add to accumulator with shift 
Add to high accumulator 

Add to low accumulator with 

sign extension suppressed 
Add to accumulator with shift 
specified by T register 

Add to accumulator 

long immediate with shift _ 

AND with accumulator 

AND immediate with accumulator with 
shift 

Complement accumulator 

Load accumulator with shift 

Load accumulator immediate short 
Load accumulator with shift 
specified by T register 

Load accumulator long 

immediate with shift 

Negate accumulator 

Normalize contents of accumulator 
OR with accumulator 

OR immediate with accumulator with 
shift 

Store high accumulator with shift 
Store low accumulator with shift 
Subtract from accumulator 

long immediate with shift 

Shift accumulator left 

Shift accumulator right 

Subtract from accumulator with shift 
Conditional subtract 

Subtract from high accumulator 
Subtract from low accumulator 
with sign extension suppressed 
Subtract from accumulator with 
shift specified by T register 
Exclusive-OR with accumulator 
Exclusive-OR immediate with 
accumulator with shift 

Zero accumulator 

Zero low accumulator and load high 
accumulator 

Zero accumulator and load low 
accumulator with sign extension 
suppressed 


AUXILIARY REGISTERS AND DATA PAGE POINTER INSTRUCTIONS 


Instruction Bit Code 


16 1413121110 9 8 7 6 5 4 3 21 =«0 
1 1 


01411100 14 0 1 0 0<CM> 


01010 |———p——~ 
1+—-S———- 0 0 00001 0 


011410 I-———- D-———> 


10 0 


—_d 
2000 0 00-0 00 0 &© oC00 


-Oo-——= 


0 1K SS VO Oe 
0: 0 | ee 


i S>—— 0 0 0 0 0 01 1 


-OO 


1 


— — — () — — 


-O Oo ooo°o-- 

Oo oOo oOo oO oooceooeo eo-- 
- oO © ooo-0 0 
| - © coo [++ 


oO oO 





Mnemonic Description 


CMPRt Compare auxiliary register with 
auxiliary register ARO 

LAR Load auxiliary register 

LARK Load auxiliary register immediate short 


oO 













= 2 
RK 


LARP Load auxiliary register pointer 10 1 1 0 0 0°41 R 

LDP Load data memory page pointer “010 ire-_— D)D——-> 

LDPK Load data memory page pointer 00——— K —___—_—_———_——— 
immediate 


=F 0: 0-0. 0 50. 0.0 0 


10%. ———p———— 


pee Ret |g —— — ——— [) 


LRLKt Load auxiliary register long immediate 
MAR Modify auxiliary register 
SAR Store auxiliary register 


-O0O0O oo°o°o- 





TThese instructions not included in the TMS32010 instruction set. 
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TABLE 2. INSTRUCTION SET SUMMARY (CONTINUED) 


T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS 


Mnemonic Description woe Instruction Bit Code 


Add P register to accumulator 
Load high P register 

Load T register 

Load T register and accumulate 


ol 


15 14 13 1 


1 
1 
0 
1 
1 


--OO]W 


previous product 

Load T register, accumulate previous 
product, and move data 

Load T register and store P 

register in accumulator 

Load T register and subtract 

previous product 

Multiply and accumulate 

Multiply and accumulate 

with data move 

Multiply (with T register, store product 
in P register) 

Multiply immediate 

Load accumulator with P register 
Subtract P register from accumulator 
Set P register output shift mode 
Square and accumulate 

Square and subtract previous product 


BRANCH/CALL INSTRUCTIONS 


N 
Mnemonic Description Words Instruction Bit Code 


| ss |45 1413121110 9 8 7 6 5 4 3 21 0 


Oo. | 

4.13 12 

B Branch unconditionally 2 PVD DDD ne Dnt 

BACCt Branch to address specified by 1 1 0 0 1 1000100 10 = 41 
accumulator 

BANZ Branch on auxiliary register not zero 

BBNZt Branch if TC bit # 0 

BBZt Branch if TC bit = 0 

BGEZ Branch if accumulator >0 

BGZ Branch if accumulator > 0 

BIOZ Branch on |/O status = 0 

BLEZ Branch if accumulator < 0 

BLZ Branch if accumulator < 0 





© oe) oO-f H][f 






= 


oo.—6UwOClCOOS © ooo 
—_ 


Ooo — oO 
—_ 


_ -_ 
— 








———— DD -— 
w—e_————- D -—-—-——-——> 
i OO 
1 <——$—$—$—$—._ 0D —__+> 
1 <——_—_—_—_——. 0D —_> 
1 <—_———_—_—. 0p —————> 
1 -————._ Dp _—___+ 
1<—_—————  p—_—_——— 
1 $$$. 0 ——_———+ 
1D ——_—_——— 
1, 0 
ee 
001 0 0 10 0 
i—_—_— 0—_—_—_—> 


0010 0 1 1 =0 


BNVTt Branch if no overflow 
BNZ Branch if accumulator # 0 
BV Branch on overflow 

BZ Branch if accumulator = O 
CALA Call subroutine indirect 
CALL Call subroutine 

RET Return from subroutine 


— NO — BRO DO DO DO AO DO AO DO AD PO AO DO 
i ah atl ti se casas Gat a ee ee te 
i Pea ircaeancie te re ie eee ae 
O- Of 22222224345 
a eee eee 
---000000-00-=— 
==3==-30--0000-000 
~3-32300--==0000— 
CO000---00-00-— 


TThese instructions not included in the TMS32010 instruction set. 
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Mnemonic 


[TO—COC“‘(C;*‘*dS*#*d‘S 09 B75 DDT 






BITTt 
CNFDt 
CNFPt 
DINT 
EINT 
IDLEt 
LST 
LSTit 
NOP | 
POP 
POPDt 
PSHDt 
PUSH” 
ROVM 
RPTt 


RPTKtT 


RSXMt 
SOVM 
SST 
SSTit 


_ TABLE 2. INSTRUCTION SET SUMMARY (CONCLUDED) 


CONTROL INSTRUCTIONS 


Description 


Test bit 
Test bit specified by T register 
Configure block as data memory 
Configure block as program memory 
Disable interrupt 

Enable interrupt 

Idle until interrupt 

Load status register STO 

Load status register ST1 

No operation . 

Pop top of stack to low accumulator 
Pop top of stack to data memory 
Push data memory value onto stack 
Push tow accumulator onto stack 
Reset overflow mode 

Repeat instruction as specified 

by data memory value 

Repeat instruction as specified 

by immediate value 

Reset sign-extension mode 

Set overflow mode 

Store status register STO 

Store status register ST1 

Set sign-extension mode | 

Software interrupt 















Instruction Bit Code 














































4 
1 0) 0 = ee SS 
1 PO Oe Ph OS De 
1 10014 11000000 10 «0 
1 10 0 1 1 1 0 0 00 0 010 =1 
1 1001 11 00000 0 00 =4 
1 10 01 11 000 00 0 00 0 
1 1001 11 000 0 1 41 4 1 ~=41 
1 O°. 2 OO OO Oh ————— 
1 101 00 04 |————— D ————> 
1 10101 01 00 0 0 0 00 0 
1 100 1 1 1 000 0 1 41 10 ~=41 
1 Lor tot Ob: ————— lp 
1 HO: 3 Or A OOO 
1 1-001 1 1 000 01 4°10 0 
1 10014 11 00 0 0 00 01 0 
1 120) 20s Ae 200 4). ol eee | Dee: 
1 LO OT — SSS 
1001 11 0000 00 1 1 «0 
10 01 1 1 0000 0 0 01 41 
Tee AR Ae SD OP Qe OE” rere Deemer: 
111 10031 0———D——-> 
10 01 1 1 0000 0 0 11 1 
1 0 O 110000 1 4 4 1 .~=0 





| 1/O AND DATA MEMORY OPERATIONS 


No. 
Mnemonic _ Description Instruction Bit Code 


15 1413121110 9 8 7 6 5 43 21 =0 
1 1 4 4 4 +14 0 1 : 





-BLKPt 


DMOV 
FORTTt 
IN 
OUT 
RTXMt 
RXFt 
STXMt 
SXFt | 


Block move from data memory to 
data memory 

Block move from program memory 
to data memory 

Data move in data memory 

Format serial port registers 

Input data from port 

Output data to port 

Reset serial port transmit mode 
Reset external flag 

Set serial port transmit mode 

Set external flag 

Table read 
Table write 















1 1 #1 















Ne ee ee ee ee ap ee 
oooo0o0°o?co0°coe 
--"OOOCd0O000- 


0 
j 
1 
1 
1 
1 
1 
1 
0 
0 


tThese instructions not included in the TMS32010 instruction set. 
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development systems and software support 


Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS32020-based microprocessor system. When developing an application, tools are provided to evaluate 
the performance of the processor, to develop the algorithm implementation, and to fully integrate the 
design’s software and hardware modules. When questions arise, additional support can be obtained by 
calling the nearest Texas Instruments Regional Technology Center (RTC). 


Sophisticated development operations are performed with the TMS32020 Macro Assembler/Linker, 
Simulator, and Emulator (XDS). The macro assembler and linker are used to translate program modules 
into object code and link them together. This puts the program modules into a form which can be loaded 
into the TMS32020 Simulator or Emulator. The simulator provides a quick means for initially debugging 
TMS32020 software while the emulator provides the real-time in-circuit emulation necessary to perform 
system level debug efficiently. 


Table 3 gives a complete list of TMS32020 software and hardware development tools. 


TABLE 3. TMS32020 SOFTWARE AND HARDWARE SUPPORT 


Host Computer Part Number 
DEC VAX TMDS3241 210-08 
TI/IBM PC TMDS3241810-02 
a 
Host Computer Part Number 
DEC VAX TMDS3241 211-08 
TIIBM PC MS/PC-DOS TMDS324181 1-02 
a 
omar Sunely 
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absolute maximum ratings over specified temperature range (unless otherwise noted) Tt 


Supply voltage range, Vcct........ cue bai ohn oa ates Yee ae andes SOS Vito 7 V 
Input voltage range...... ee eee ee “get tee She Me eS Se Rast oh Taco Sipe ek Sek eg te pan wee =O.3 V to 7 V 
Output voltage range. .......... 2.0.2.0 eee eee Noe hd aie ase he ee ale 1. -0.3Vto7V 
Continuous power dissipation.......... eens sgh ae, eve av teste AT Sate, ess Ragen, a ede ge ca beamen (220-W 
Operating free-air temperature range................ ee a eee by Adak: sees eee O0°C to 70°C 
Storage temperature range......... lo, Soe ea, Mets Wh Raa RIA At nae Se EE eas ee eh -55°C to 150°C 


T Stresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

TAIl voltage values are with respect to Vss. 


recommended operating conditions oe | | 
Vcc Supply voltage 4.75 5 5.25 
Vss Supply voltage ae eee 


| All inputs except CLKIN 2 Vcc +0.3 
vie iaidholeverigouewenaae cct03[ Vv 
CLKIN 2.4 Vect0.3 | vi 
IL ee 


V 
V 
V 
— All inputs except CLKIN -0.3 OF 0.8 V 
V Low-level input voltage 
CLKIN —0.3 0.8 V 
High-level output current 


OH | 
lo. Low-level output current 
TA Operating free-air temperature (Notes 1 and 2) 0 | 70 


NOTES: 1. Case temperature (Tc) must be maintained below 90°C. 
2. RaJA = 36°C/Watt; Rajc =6°C/Watt. 















electrical characteristics over specified free-air temperature range (unless otherwise noted) 


v 
id 
i uA 
T A 
250 A 

A 

pF 

pF 










O| oO 


Input current 








© 





Supply current 






Ta = 25°C, Vcc = SV, fy = MAX fF 250000 Tum 
m 
aaa ae ee eee -F 
ee ae see es ce ad 





Ea 
A 
A 
mA 
ma 
CaF | 


C| Input capacitance 
Co Output capacitance 


TAII typical values are at Vcc = 5 V, Ta = 25°C. : 


A 


i y q Caution. This device contains circuits to protect its inputs and outputs against damage due to high static voltages or electrostatic 

fields. These circuits have been qualified to protect this device against electrostatic discharges (ESD) of up to 2 kV according 

to MIL-STD-883C, Method 3015; however, it is advised that precautions be taken to avoid application of any voltage higher than maximum 

rated voltages to these high-impedance circuits. During storage or handling, the device leads should be shorted together or the device 

should be placed in conductive foam. In a circuit, unused inputs should always be connected to an appropriate logic voltage level, preferrably 

either Vcc or ground. Specific guidelines for handling devices of this type are contained in the publication ‘Guidelines for Handling Electrostatic- 
Discharge Sensitive (ESDS) Devices and Assemblies’’ available from Texas Instruments. : 
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CLOCK CHARACTERISTICS AND TIMING 


The TMS32020 can use either its internal oscillator or an external frequency source for a clock. 
internal clock option | 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 2). The 
frequency of CLKOUT1 is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. | 


67 20-5 


; ANE ; 
T T 










FIGURE 2. INTERNAL CLOCK OPTION 


external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X11 left 
unconnected. The external frequency injected must conform to the specifications listed in the following table. 


switching characteristics over recommended operating conditions (see Note 3) 


PARAMETER 
tc(C) CLKOUT1/CLKOUT2 cycle time 195 597 | ns | 


td(CIH-C) _CLKIN high to CLKOUT1/CLKOUT2/STRB high/low 25 60 
tHiC) CLKOUT1/CLKOUT2/STRB fall time P10 ns 


tric) CLKOUT1/CLKOUT2/STRE rise time a ao 
tw(CL) CLKOUT1/CLKOUT2 low pulse duration 20-15 2Q 20+15 | ons | 
tw(CH) __ CLKOUT1/CLKOUT2 high pulse duration 20-15 20 20+15 


td(C1-C2) CLKOUT1 high to CLKOUT2 low, CLKOUT2 high to CLKOUT1 high, etc. Q-10 Q Q+10 


















NOTE 3: OQ = 1/4tgc). 
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timing requirements over recommended operating conditions (see Note 3) | 


| MIN NOM MAX | UNIT 
tc(Cl) 


) ei «|: 48.8 150 | ns | 
eich) CERIN Tal time C10 [re] 
iG) CLIN ise time eienteneee eer Oey ae 

























CLKIN cycle time 


twi(CIL) CLKIN low pulse duration, tc(Cl) = 50 ns (Note 4) 7 10 ) 40 
twi(CiH) CLKIN high pulse duration, teicl) = 50 ns (Note 4) 
15 





tsu(S) SYNC setup time before CLKIN low | - | / 10 = a-10 | ns | | 
this) SYNC hold time from CLKIN low | | is ts—“;‘iLCSis—SC 


NOTES: 3. Q = 1/4tgicy. . : 
4. CLKIN duty cycle [tr(c}) + tw(CIH)!/tc(cl) Must be within 40-60%. 





2.15 V 


FROM OUTPUT 
UNDER TEST 










= SS SS —— Vin (MIN) 
SS =] = = 2 Vit (MAX) 


(a) INPUT 


am Von (MIN) 


Voit (MAX) 


(b) OUTPUTS 


FIGURE 4. VOLTAGE REFERENCE LEVELS 
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clock timing 


fo feich 
tric —ol fe -o| een 










X2/CLKIN 
| . beat (CIH) 
Le le-tsuis) | feet tsus | ae w 
SYNG le— this) | ! eo 
| td(CIH-C) aes een 
CLkouT1 | | i | ‘w(Cl) twiCH) 


yao | fo—et-tarcin-c) | tciC) | 
CLKOUT2 tw(CH) twiCL)—+ 


| fet 1-2) 
be——el — (61-02) 
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MEMORY AND PERIPHERAL INTERFACE TIMING | 


switching characteristics over recommended operating conditions (see Note 3) 


PARAMETER MIN TYP MAX 
tgic1-S) STAB from CLKOUT1 (if STRB is present) | o-15 Oo 0415 


tg(C2-S) CLKOUT2 to STRB (if STRB is present) 15 = 0 15 


tsu(A) Address setup time before STRB low (Note 5) | | | ons | 
th(A) Address hold time after STRB high (Note 5) | a fon ts 
twi(SL) | STRB low pulse duration (no wait states, Note 6) | Pe oe A tne 
tw(SH) STRB high pulse duration (between consecutive cycles, Note 6) i a ee ee 

Q [ons 






















20 

20 
tsu(D)W _—ODaata write setup time before STRB high (no wait states) oe tc 
ee 
0 25 





ns 
ns 
ns 
ten(D) Data bus starts being driven after STRB low (write cycle) | fe Oe ad 

| tdis(D) |: Data bus three-state after STRB high (write cycle). . | ns 


NOTES: 3. Q = 1/4te(C). 
5. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘address.’ 
6. Delays between CLKOUT 1/CLKOUT 2 edges and STRB edges track each other, resulting in tyw(S_) and tw(SH) being 20 with no 
wait states. : : 








timing requirements over recommended operating conditions (see Note 3) 


ta(A) Read data access time from address time (read cycle, Notes 5 and 7) 30-70 











ae cee eee ne ae 
Se Ieee none cnioneton es renin) 
arene a ees arene 
a=40 [ns 
oak  ebthin ie es eta 
th(M-R) __ READY hold time after MSC valid Foo) ns 


NOTES: 3. Q = 1/4tg(c). | 
5. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.’’ 
7. Read data access time is defined as ta(A) = tsu(A) + tw(SL) — tsu(D)R- 
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memory read timing 


*#————-+- ta(C1-S) 
| 
CLKOUT1 | 
| 
| 
| ———+- tac 1-5) 


CLKOUT2 | | 
| 


ke td(C2-S) 
















RAAARAAS 
DO 





WPAAAAAARAAAAAAASASALAASALAAAAAAAALAAAAA LY 
IOC IOI 
ICICI ICICI 

OOOO OO) | | 


BN AOADOOAOOIODAOC CCC C ICI CIC 
CR 











KX KAS KXAN K RRR K RRA K KRY XS 
SOOO OOOO OOOO OOOO OOOO OX) 


A NNN NNN NEI NEN 


READY 


OO 


MOYO IIIA Cy y vy yy yy 


| [1 
t = —4—_—__+ 


D15-DO a A 


memory write timing 


CLKOUT1 


CLKOUT2 
















—\MAAAAARAAAAARSRARAARAAAARAAAAP LE Arodr xd 
(X) ¥ 
OOOO OOO OO OI IK 
4040004006404 0500640000OH OOOO Oe 
OOOO OOOO OOOO COCO SY 
OOK AO AO OO 
OOO A AA OAK Af 


[_ AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/ 


OOOO OOO OAK XK AARAXAAAAXA 


SO RRO 
OOOO OOOO) 


NNN NNN NN NE ENN NS 








READY 












OOOO 


XOXO 
NYY XK 


2asshaar 


D15-D0 







| 
k— tdis(D) > 
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one wait-state memory access timing 





B-20 







CLKOUT1 


CLKOUT2 


PTT TC sh RESIST ermine et ema nm I ar LP en I Pa Nn Rn a I Ie CTT ne ro aan Pa OR En ee nner 


AA ARRAARAKAAKARKARAAKARKRARRRAARAD 
) 
‘ KY MY AN KY KY KY ‘ NM VJ AN NM AN XN M * WY AN AM WN KN Ny Ny A A KN 






D15-D0O 
(FOR READ 
OPERATION) 


D15-D0 
(FOR WRITE 


OPERATION) 


PAA 


a OR PUI RRO DUOR ROR URE rr rer area 


XXX ARRRAARRRAAKAAAAAAAAAAARAG 
RAK) 
14.O0O060000060000006060000008 oe Ms AAA AA 


CAAA AAA AR AA AY DAOOOIOOOOOOOOO OO OIK KOCK NAM) 


090000000000000008 
06.00.0.0.0008. RACK KICK IC | | ¥..6.0.66.060.6.6000006060000000 0008 


+ taimscy) | | 
a i ta(MSC) 














MSC 
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RS, INT, BIO, and XF TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


tains) CLKOUTI ow to eset sate entered ——SCSCSC—C—“Ss‘“‘“s*é‘~iSSSS 


NOTE 3: Q = 1/4tgc). 
8. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup 
time is met, the exact sequence shown in the timing diagrams will occur. 










timing requirements over recommended operating conditions (see Note 3) 


tsu(IN) INT/BIO/RS setup before CLKOUT1 high 


th(IN) /BIO/RS hold after CLKOUT1 high 


tf(IN) fall time 


ow pulse duration 





twiRS low pulse duration 


NOTE 3: Q = 1/4tgic)- 
8. RS, INT, and BIO are asynchronous inputs and can occur at any time during a clock cycle. However, if the specified setup time 
is met, the exact sequence shown in the timing diagrams will occur. 


reset timing 


CLKOUT1 ! f 
| 
*—tsu(IN) | 
| th(IN) . 
. omni ff ff 
A1BS-AO XR OK, QO VALID 


{ 
{ 
D1B-DO CORR) 


OOK OO OOK OOK OK OOK KK V A LI D (7 ) 
ee En! | 


PS KK KK KKK KKK KKK KY, | 
| 


==—— KX OOOO OOK OKO KOK KY 
STRB QYKRKRKRXKRK EX KEK RAKKARKE LER AY | 


i 
{ 
CONTROL XXXXKXKKXOOOO OOO OOOO OOOO OOOO CK XY 
SIGNALS 1 RRR RRR KY 






LOCATION 0 








BEGIN 
PROGRAM 
EXECUTION 









a | XX XX MK KXKKXKKK) XXX) XX KK) OOOO 
WACK QO KKK ALYY, ies RXR KH 


CONTROLS! XXXRRRXRKKKRRKRRKRKRK KERRY 


‘Control signals are DS, 1S, R/W and XF. 
+ Serial port controls are DX and FSX. 
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interrupt timing 


- CLKOUT1 





ee: tees Lt nn 
INT2-INTO Ke mt) Ty ) | a 
| | l | | 


A15-A0 





IACK 969060000008 


0000000008 | 


| 
ta(lack)  ¢- > 


eae Re EEN 


+ ta(IACK) 


| | 
| | 
| 


STRB 
FETCH | FETCH 
BRANCH ADDRESS , NEXT INSTRUCTION 
3, ae FETCH Me. aX) 
aloe GED: CD: GRD 
PC =N PC=N+1 1 
| | 
jr th(IN) 
tsu(IN) io | PC=N+2 
: | | OR BRANCH ADDRESS 
{ 


BIO 
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external flag timing 





>| je— ta(XF) 

a “| ot 
A15-A0 eS pada ae VALID . VALID 
PC=N PC=N+1 PC=N+2 

















OO ercreronru RRR ARAARRRRI IAAI 
XX AX KXYXX RX RK KXRAXRY RAK RA RAR RRR KE RK EK ERK RK KER 
KAN AXX AXA AXA PRAN ERAN RE SOREN WRX ERAXY RRA 
RY YK KKK KKK KKK KL 


XF 
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HOLD TIMING 


switching characteristics over recommended operating conditions (see Note 3) 


| PARAMETER | | MIN TYP MAX 
td(C1L-AL) FOLDA low after CLKOUT1 low | = 25 25 | ns | 


tdistAL-a) HOLDA low to address three-state : ce 
tdis(C1L-A) Address three-state after CLKOUT1 low (HOLD mode, Note 5) 


td(HH-AH) HOLD high to HOLDA high | : 
ten(A-C1L) Address driven before CLKOUT1 low (HOLD mode, Note 5) | 









NOTES: 3.0 = 1/4tgc). | 
5. A15-A0, PS, DS, IS, R/W, and BR timings are all included in timings referenced as ‘‘address.’’ 


timing requirements over recommended operating conditions (see Note 3) 
i | MIN NOM Max | UNIT 


NOTE: 3. Q = 1/4tg¢). 









HOLD timing (part A) 


| | 


| 
__ | 
STRB | 

| : 


HOLD 





A15-A0 


D15-D0O 


FETCH 








EXECUTE 


ER ETL SET o | | 
HOLDA | | | | \U 
| | | 


td(C1L-AL) —p l¢e— 
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HOLD timing (part B) 





CLKOUT1 
1 | 
| | 
| R XK ¥) vy v *, 
STRB | RRA 
—»! le ta(c2H-H) | | 
Tanah | | 
HOLD ] —> je ten(A-C1L) 
| | 
| 
A15-A0 
PS,DS, 
OR IS 
R/W | 
D15-D0 
FETCH 
l 
DEAD DEAD N+1 N+2 
EXECUTE — s+ + vo va meue——_—> 


HOLDA —»i Ja— tatHH-AH) 
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SERIAL PORT TIMING 





switching characteristics over recommended operating conditions (see Note 3) 


PARAMETER MIN TYP MAX 


. td(CH-Dx) DX valid after CLKX rising edge (Note 9) Po 100 Fons 
td(FL-DX) DX valid after FSX falling edge (TXM = 0, Note'9) 7 


td(CH-FS) FSX valid after CLKX rising edge (TXM = 1) 


NOTES: 3. Q = 1/4tg(c). | 
9. The last occurrence of FSX falling and CLKX rising. 












timing requirements over recommended operating conditions (see Note 3) 












ttiSCK) Serial port clock (CLKX/CLKR) fall time. | | 


[trisck) Serial port clock (CLKX/CLKRI rise time SSSCSCSC~d SSCS] 
150 12,000 | ns 

tsu(FS) __ FSX/FSR setup time before (CLKX/CLKR) falling edge (TXM = 0) 
20 


NOTES: 3. Q = 1/4tg(c). : 
10. The duty cycle of the serial port clock must be within 40-60%. 





serial port receive timing 
"aaa tc(SCK) —> 
kg-——-—pE 


| 1 | 
tr(SCK) > le | 


twi(SCK) 












or /-*x\_/ \_/ | 
| | 
t 
ESR / iF | > lt h(DR) 
po odt | SS 


| a 
l¢—p! tsu(FS) e—pr- tsu(DR) 


RRR rr 
A; x) XXX) XXX YY XX XY) AV Ky mn 

OOOO 
YVAN YY “" O ni Uy 
















: ; POX KKK KKK KKK RRR KKK 
BOOIOOOOO OOOO OOK 
SANIOOOOOOUO OOOO KK Xd 
XU RAR RRR RRR RRR ARR ARG 
YY YYYYYYYYY YY XX XX 1) 











DR 


serial port transmit timing 


¢—— tc(SCK) —» 


| 
*wiSCk) —» Ky ig trSCK) 


4 ; 
i \ 
' \ 
ig HISCK) Dy it ts 


\¢-———_»- ‘twiSCK) 


| 
! 
| 
| 


FSX 
(INPUT, TXM = 0) 


' 
‘ 
| 

{ | 

i | 

! 

t | 
{ 


me 

F 

wT 

ow 
~~ Se 


{ 

! 

! | | @—p- td(CH-DX) ai 

| ta(FL-Dx) +e Sr ) gt Md (CH-DX) 
| 


i¢ tsu(FS) | 
Dx | 
+> td (CH-F 
FSX = 


(OUTPUT, TXM = 1) ! 
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MECHANICAL DATA 
68-pin GB pin grid array ceramic package 


TOP VIEW 


28,448 (1.120) 
27,432 (1.080) 


17,02 (0.670) 


Nom 


THERMAL RESISTANCE CHARACTERISTICS 
PARAMETER | MAX, UNIT oe aS tr Oaoe 
| 
OJA ; 17,02 (0.670) 
thermal resistance . NOM 
R Junction-to-case oC/W 
bJC thermal resistance 


















4,953 (0.195) 
2,032 (0.080) 1,397 (0.055) 
MAX 
3,302 (0.130) 0,508 (0.020) UU oes DIA 
a0 aio 0,406 oor 1,473 (0.058) 
ee oe BOTTOM VIEW 


"nN" QO DTD & KAR CF 





E 
D 
c aca tee 
? OO© 000000601 4 PLACES 
A\ ©OO©©©©© © ©—-+ 

1 2 3 4 5 6 7 8 9 10 11 £127 10-050) 


ALL LINEAR DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 








43 
TEXAS ae 
INSTRUMENTS 


POST OFFICE BOX 1443 @® HOUSTON. TEXAS 77001 


B-28 






ADVANCE 
INFORMATION 






200-ns Instruction Cycle 
144-Word On-Chip Data RAM 
ROMless Version — TMS320C10 


1.5K-Word On-Chip Program ROM — 
TMS320CM10 


External Memory Expansion to a Total of 4K 
Words at Full Speed 


16-Bit Instruction/Data Word 

32-Bit ALU/Accumulator 

16 x 16-Bit Multiply in 200 ns 

0 to 16-Bit Barrel Shifter 

Eight Input and Eight Output Channels 


16-Bit Bidirectional Data Bus with 
40-Megabits-per-Second Transfer Rate 


Interrupt with Full Context Save 


Signed Two’s-Complement Fixed-Point 
Arithmetic 


CMOS Technology 
Single 5-V Supply 


description 


The TMS320C10 is the first low-power CMOS 
member of the Texas Instruments TMS320 
family of Digital Signal Processors. This device 
is a CMOS pin-for-pin compatible version of the 
industry-standard TMS32010 Digital Signal 
Processor. The 100-mW typical power 
dissipation of the TMS320C10 enables power- 
sensitive applications to take advantage of the 
TMS32010’s high performance. The 16/32-bit 
microcomputer was designed to support a wide 
range of high-speed and numeric-intensive 
applications. The TMS320C10 combines the 
flexibility of a high-speed controller with the 
numerical capability of an array processor, 
thereby offering an inexpensive alternative to 
multichip bit-slice processors. The highly 
pipelined architecture and efficient instruction 
set of the TMS320C10 provides the capability 
of executing more than five million instructions 
per second. The instruction set is easily 
programmed and contains general-purpose as 
well as digital signal processing instructions. 


ADVANCE INFORMATION documents contain ; Copyright © 1986, Texas Instruments Incorporated 
information on new products in the sampling or 43 | 
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N PACKAGE 
(TOP VIEW) 





a0] A2/PA2 
391] A3 


A1/PA1 LI} 1 
AO/PAO L] 2 


MC/MPL]}3 38LJ A4 
RS (4 37[)A5 
INTL}]5 36L] A6 

CLKOUT L116 35LJA7 
X1L}7 34L)A8 
X2/CLKIN(J8 330] MEN 
BIO CJ9 = 332] DEN 

Vss Lj10 310] WE 
D8 t}J11 30} Vcc 
D9[}12 291] A9 
bD10(}13 28] A10 


D11[}14 27,}A11 
D12{415 26[{D0 
D13 [316 25]7]D1 
247] D2 
23] D3 
221] D4 
21{]D5 


FN PACKAGE 
(TOP VIEW) 
O=- N 
E<< ¢ 
EwSLz2e2eee 
4 3 2 1 4443424140 
CLKOUT |]7 0 391] A7 
X11}8 38l] A8 
X2/CLKIN[]9 371] MEN 
BIO [J10 36L] DEN 
NC {}11 35[] WE 
Vssu12 344} Vcc 
D8ij13 33[f AQ 
D9{}14 32] A10 
D10{J15 31{f A11 


30[} DO 
29|} D1 
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| . | PIN NOMENCLATURE “ss | , <i ) 
| Name | vo 
A11-A0/PA2-PAO External address bus. I/O port address multiplexed over PA2-PAO. i 3 . 
BIO 
CLKOUT 
D15-DO 


DEN 
INT 





















External polling input for bit test and jump operations. 





‘System clock output, % crystal/CLKIN frequency. 
16-bit data bus. 
Data enable indicates the processor accepting input data on D15-DO. | 











Interrupt. 
Memory mode select pin. High selects microcomputer mode. Low selects microprocessor 
mode. | 

Memory enable indicates that D15-DO will accept external memory instruction. 

No connection. 
Reset used to initialize the device. 






Power. 






Ground. 
Write enable indicates valid data on D15-D0O. 


VSS 
WE 
x1 
X2/CLKIN 








Crystal input. 





Crystal input or external clock input. 


The TMS320 family’s unique versatility and power give the design engineer a new approach to a variety 
of complex applications. In addition, these microcomputers are capable of providing the multiple functions 
often required for a single application. For example, the TMS320 family can enable an industrial robot to 
synthesize and recognize speech, sense objects with radar or optical intelligence, and perform mechanical 
operations through digital servo-loop computations. | 


architecture 


The TMS320 family utilizes a modified Harvard architecture for speed and flexibility. In a strict Harvard 
architecture, program and data memory lie in two separate spaces, permitting a full overlap of the instruction 
fetch and execution. The TMS320 family’s modification of the Harvard architecture allows transfers 
between program and data spaces, thereby increasing the flexibility of the device. This modification permits 
coefficients stored in program memory to be read into the RAM, eliminating the need for a separate 
coefficient ROM. It also makes available immediate instructions and subroutines based on computed values. 


The TMS320C10 utilizes hardware to implement functions that other processors typically perform in 
software. For example, this device contains a hardware multiplier to perform a multiplication in a single 
200-ns cycle. There is also a hardware barrel shifter for shifting data on its way into the ALU. Finally, 
extra hardware has been included so that auxiliary registers, which provide indirect data RAM addresses, 
can be configured in an autoincrement/decrement mode for single-cycle manipulation of data tables. This 
hardware-intensive approach gives the design engineer the type of power previously unavailable on a single 
chip. 

32-bit ALU/accumulator 


The TMS320C10 contains a 32-bit ALU and accumulator that support double-precision arithmetic. The 
ALU operates on 16-bit words taken from the data RAM or derived from immediate instructions. Besides 
the usual arithmetic instructions, the ALU can perform Boolean operations, providing the bit manipulation 
ability required of a high-speed controller. | 
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functional block diagram 


X1 
CLKOUT X2/CLKIN 












16 
WE 
DEN & Ci 
MEN 3 
Eee ° 
BI = 
ae > PC (12) INSTRUCTION 
MC/MP Oo 
ae Oo 
INT ” 
aes “7 PROGRAM 
R cc ROM 
O | (1536 x 16) 
STACK 4 
4x12 
A11-A0/ 
PA2-PAO 


16 


PROGRAM BUS D15-D0 


f 4 ° 


ARP ARO (16) ¢ 










MULTIPLIER 


DATA RAM 
(144 x 16) 
LEGEND: 


ACC= Accumulator 

ARP= Auxiliary register pointer 
ARO= Auxiliary register O 
AR1= Auxiliary register 1 
DP = Data page pointer 


PC = Program counter 
P = P register 
T = T register 


SHIFTER (0, 1, 4) 


DATA BUS 
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shifters 


A barrel shifter is available for left-shifting data O to 15 places before it is loaded into, subtracted from, 
or added to the accumulator. This shifter extends the high-order bit of the data word and zero-fills the 
low-order bits for two’s-complement arithmetic. A second shifter left-shifts the upper half of the accumulator 
O, 1, or 4 places while it is being stored in the data RAM. Both shifters are useful for scaling and bit 
extraction. | 


16 x 16-bit parallel multiplier 


The TMS320C10’s multiplier performs a 16x 16-bit, two’s-complement multiplication in one 200-ns 
instruction cycle. The 16-bit. T Register temporarily stores the multiplicand; the P Register stores the 32-bit 
result. Multiplier values either come from the data memory or are derived immediately from the MPYK 

(multiply immediate) instruction word. The fast on-chip multiplier allows the TMS320C 10 to perform such 
fundamental operations as convolution, et and filtering at the rate of better than 3 million samples 
per second. : 


program memory expansion 


The TMS320CM10 is equipped with a 1536-word ROM, which is mask-programmed at the factory with 
a customer’s program. It can also execute from an additional 2560 words of off-chip program memory 
at full speed. This memory expansion capability is especially useful for those situations where a customer 
has a number of different applications that share the same subroutines. In this case, the common subroutines 
can be stored on-chip while the application specific code is stored off-chip. _ 


The TMS320CM10 can operate in either of the following memory modes via the MC/MP pin: 


Microcomputer Mode (MC) — Instruction addresses O-1535 fetched from on-chip ROM; instruction 
addresses 1536-4095 fetched from off-chip memory at full speed. 


Microprocessor Mode (MP) — Full-speed execution from all 4096 off-chip instruction addresses. 


The TMS320C10 is identical to the TMS320CM10, except that the TMS320C10 operates only in the 
microprocessor mode. Henceforth, TMS320C10 refers to both versions. 


The ability of the TMS320C10 to execute at full speed from off-chip memory provides the following 
important benefits: 


Easier prototyping and development work than possible with a device that can address only on-chip ROM, 
Purchase of a standard off-the-shelf product rather than a semicustom mask-programmed device, 
Ease of updating code, | 

Execution from external RAM, 

Downloading of code from another microprocessor, and 

Use of off-chip RAM to expand data storage capability. 


input/output 


The TMS320C10’s 16-bit parallel data bus can be utilized to perform I/O functions at burst rates of 40 
million bits per second. Available for interfacing to peripheral devices are 128 input and 128 output bits 
consisting of eight 16-bit multiplexed input ports and eight 16-bit multiplexed output ports. In addition, 
a polling input for bit test and jump SpeleHons (BIO) and an interrupt pin (INT) have been incorporated 
for multitasking. : 


interrupts and subroutines 


The TMS320C10 contains a four-level hardware stack for saving the contents of the program counter 

| -. during interrupts and subroutine calls. Instructions are available for saving the TMS320C10’s complete 
~ context. The instructions, PUSH stack from accumulator and POP stack to accumulator, permit a level 
of nesting restricted only by the amount of available RAM. me interrupts used in the TMS320C10 are 
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instruction set 


The TMS320C10’s comprehensive instruction set supports both numeric-intensive operations, such as 
signal processing, and general-purpose operations, such as high-speed control. The instruction set, explained 
in Tables 1 and 2, consists primarily of single-cycle single-word instructions, permitting execution rates 
of better than 5 million instructions per second. Only infrequently used branch and 1/O instructions are 
multicycle. 

The TMS320C10 also contains a number of instructions that shift data as part of an arithmetic operation. 
These all execute in a single cycle and are useful for scaling data in parallel with other operations. 


Three main addressing modes are available with the TMS320C10 instruction set: direct, indirect, and 
immediate addressing. 


direct addressing 


In direct addressing, seven bits of the instruction word concatenated with the data page pointer form the 
data memory address. This implements a paging scheme in which the first page contains 128 words and 
the second page contains 16 words. In a typical application, infrequently accessed variables, such as those 
used for servicing an interrupt, are stored on the second page. The instruction format for direct addressing 
is shown below. 


15 14 13 12 11 10 9 8 7 


6 5 4 3 2 1 0 


Bit 7 = O defines direct addressing mode. The opcode is contained in bits 15 through 8. Bits 6 through 
O contain data memory address. 


The seven bits of the data memory address (dma) field can directly address up to 128 words (1 page) 
of data memory. Use of the data memory page pointer is required to address the full 144 words of data 
memory. 


Direct addressing can be used with all instructions requiring data operands, except for the immediate operand 
instructions. 


indirect addressing 


Indirect addressing forms the data memory address from the least significant eight bits of one of two auxiliary 
registers, ARO and AR1. The auxiliary register pointer (ARP) selects the current auxiliary register. The 
auxiliary registers can be automatically incremented or decremented in parallel with the execution of any 
indirect instruction to permit single-cycle manipulation of data tables. The instruction format for indirect 
addressing is as follows: 


15 14 13 £412 11 10 9 8 7 6 5 4 3 2 1 0 
| oreooe tf [me fase ane] o | o [ane 
Bit 7 = 1 defines the indirect addressing mode. The opcode is contained in bits 15 through 8. Bits 7 through 


O contain indirect addressing control bits. 


- Bit 3 and bit O control the Auxiliary Register Pointer (ARP). If bit 3 = O, then the content of bit 0 is loaded 
into the ARP. If bit 3 = 1, then the content of ARP remains unchanged. ARP = O defines the contents 
of ARO as memory address. ARP = 1 defines the contents of AR1 as memory address. 
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Bit 5 and bit 4 control the auxiliary registers. If bit 5 = 1, then the ARP defines which auxiliary register 
is to be incremented by 1. If bit.4 = 1, then the ARP defines which auxiliary register is to be decremented 
by 1. Hf: bit 5 and bit 4 are zero, then neither auxiliary register is incremented or decremented. Bits 6, 2, 
and 1 are reserved.and should always be programmed to zero. 


Indirect addressing ¢ can be used with all instructions requiring data operands, except for the immediate 
operand instructions. 


immediate addressing 


The TMS320C10 instruction set contains special ‘‘immediate’’ instructions. These instructions derive data 
from part of the instruction word rather than from the data RAM. Some useful immediate instructions are 
multiply immediate (MPYK), load accumulator immediate (LACK), and load auxiliary register immediate 
(LARK). | 


TABLE 1. INSTRUCTION SYMBOLS 


SYMBOL | — | _ MEANING 


Accumulator 
Data memory address field 


Addressing mode bit 


Immediate operand field 

3-bit port address field 

1-bit operand field specifying auxiliary register 
4-bit left-shift code 

3-bit accumulator left-shift field 
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TABLE 2. TMS320C10 INSTRUCTION SET SUMMARY 





ACCUMULATOR INSTRUCTIONS 


a 50 OPCODE 
MNEMONIC DESCRIPTION INSTRUCTION REGISTER | 


1514131211109 8 7 6 5 43 2 


CYCLES | WORDS 


Absolute value of accumulator 

Add to accumulator with shift 

Add to high-order accumulator bits 

Add to accumulator with no sign 
extension 

AND with accumulator 

Load accumulator with shift 

Load accumulator immediate 

OR with accumulator 

Store high-order accumulator bits with 
shift 

Store low-order accumulator bits 
Subtract from accumulator with shift 
Conditional subtract (for divide) 

Subtract from high-order accumulator bits 
Subtract from accumulator with no sign 
extension 

Exclusive OR with accumulator 
000100 1 
q¢_ D—_— > 


Zero accumulator 
Zero accumulator and load high-order bits 
Zero accumulator and load low-order bits 


oO OoOoOoOlOomoemlCOUDUWUmUmUCOUCONUCOUNUCUCUCOOUCOOWCUCOOUCOUNULCOONCOUCOOCCOTST Csi 


¢—— Dp —_> 


with no sign extension 








AUXILIARY REGISTER AND DATA PAGE POINTER INSTRUCTIONS 


NO NO : OPCODE | 
MNEMONIC DESCRIPTION INSTRUCTION REGISTER 
CYCLES | WORDS 


1514131211109 8 7 6 5 4 3 2 1 0 
Load auxiliary register 1 
Load auxiliary register immediate 1 
Load auxiliary register pointer immediate 1 
Load data memory page pointer 1 
Load data memory page pointer immediate 1 
Modify auxiliary register and pointer 1 
Store auxiliary register 1 





— we eee lle 
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- TABLE 2. -TMS320C10 INSTRUCTION SET SUMMARY (CONTINUED) 
| BRANCH INSTRUCTIONS 


MNEMONIC DESCRIPTION eycies |wonns _ INSTRUCTION REGISTER si 
100100000000 
4@— BRANCH ADDRESS ——> 
010000000000. 
<4 BRANCH ADDRESS ———> 
110100000000 
<4—— BRANCH ADDRESS ——®> 
110000000000 
4— BRANCH ADDRESS ——> 
011000000000 
<¢—— BRANCH ADDRESS ——> 
101100000000 
<——-_ BRANCH ADDRESS —— 
101000000000 
<4— BRANCH ADDRESS ——> 
111000000000 
<4—— BRANCH ADDRESS ——> 
010100000000 
<4—— BRANCH ADDRESS ——® 
111100000000 
<—— BRANCH ADDRESS ——> 
1111100031100 
100000000000 
<4—— BRANCH ADDRESS ——®> 
1111100031101 


Branch unconditionally 

Branch on auxiliary register not zero 
Branch if accumulator = O 

Branch if accumulator 

Branch on BIO = O 

Branch if accumulator 

Branch if accumulator 

Branch if accumulator 

Branch on overflow 


Branch if accumulator 0) 
Call subroutine from accumulator 


Call subroutine immediately 


oor o0ococulUr,r[FtlmlChUOWUhmw HW ChUCOUUcw RHKCUCOOUr rPCcCOUcwwrUhUlcCOUw HK ClCOUcrKClCUOUcUwrKCOOUCcwPMCOOUlUC 


Return from subroutine or interrupt routine 








T REGISTER, P REGISTER, AND MULTIPLY INSTRUCTIONS | 


| NO NO OPCODE 
MNEMONIC DESCRIPTION ae INSTRUCTION REGISTER 
| CYCLES |} WORDS 


1514131211109 8 765 43 2 1 0 
Add P register to accumulator 11314310001 1 1~=7 
Load T register | 010 | @———D-——S 
LTA combines LT and APAC into one 
instruction 

LTD combines LT, APAC, and DMOV into 
one instruction 

Multiply with T register, store product in 
P register — 

Multiply T register with immediate 


+¢——p ——» 


<—— p+ 


<p —__» 


operand; store product in P register © 
Load accumulator from P register | 10001 1 1 0 
Subtract P register from accumulator | 100310000 
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TABLE 2. TMS320C10 INSTRUCTION SET SUMMARY (CONCLUDED) 
CONTROL INSTRUCTIONS 


OPCODE 
MNEMONIC DESCRIPTION : 
ee WORDS INSTRUCTION REGISTER 


1514131211109 8 7 6 5 4 


=k 
—_ 


Disable interrupt 

Enable interrupt 

Load status register 

No operation 

POP stack to accumulator 
PUSH stack from accumulator 
Reset overflow mode 


Set overflow mode 
Store status register 


= ea se sa a sae 
oOo oOo OO oO Oo 
= = oe oe a ek 
— eek 
= = - oe ot a ok oe et 
sa =) 2 = = oe 2 od oo 
a a ee ee ee ee > ee Se 
ore 22.4. 2 2 = 

or 2] =-—= —]2 2 = — 

— — wd = = = — 2 


ff tie 


1/0 AND DATA MEMORY OPERATIONS 


OPCODE 
MNEMONIC DESCRIPTION TRUCTI T 
ai WORDS INSTRUCTION REGISTER 


1514131211109 8 765 43 210 
Copy contents of data memory location 
into next location 
Input data from port 
Output data to port 
Table read from program memory to data 
RAM 
Table write from data RAM to program 


development systems and software support 





Texas Instruments offers concentrated development support and complete documentation for designing 
a TMS32010-based microprocessor system. When developing an application, tools are provided to evaluate 
the performance of the processor, to develop the algorithm implementation, and to fully integrate the 
design’s software and hardware modules. When questions arise, additional support can be obtained by 
calling the nearest Texas Instruments Regional Technology Center (RTC). 


Sophisticated development operations are performed with the TMS32010 Evaluation Module (EVM), Macro 
Assembler/Linker, Simulator, and Emulator (XDS). In the initial phase of developing an application, the 
evaluation module is used to characterize the performance of the TMS320C10. Once this evaluation phase 
is completed, the macro assembler and linker are used to translate program modules into object code and 
link them together. This puts the program modules into a form that can be loaded into the TMS32010 
Evaluation Module, Simulator, or Emulator. The simulator provides a quick means for initially debugging 
TMS320C10 software while the emulator provides real-time in-circuit emulation necessary to perform 
system level debug efficiently. 


A complete list of TMS320C10 software and hardware development tools is given in Table 3. 
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TABLE 3. TMS320C10 SOFTWARE AND HARDWARE SUPPORT 


HOST — OPERATING > PART 
| COMPUTER SYSTEM NUMBER 
DEC VAX | VMS | TMDS3240210-08 
TI/IBM PC MS/PC-DOS TMDS3240810-02 
TMS32010 SIMULATORS 
DEC VAX VMS TMDS3240211-08 
TIABM PC | MS/PC-DOS TMDS324081 1-02 
[____¥MS32010 DIGITAL FILTER DESIGN PACKAGE (DFDP) | 
TI PC MS-DOS DFDP-TIO01 
IBM PC | PC-DOS DFDP-IBMOO1 
| | TMS32010 HARDWARE 
Evaluation Module (EVM) RTC/EVM320A-03 
Analog Interface Board (AIB) | RTC/EVM320C-06 
‘Emulator: - 
XDS/22 TMDS3262210 
Enhanced XDS/22 (available early 1986) TMDS3262211 





absolute maximum ratings over specified temperature range (unless otherwise noted) 


SUipplV Voltages VCC Via 4.244. eden G bowen es eee dads os ee ele a ee ee —-O0.3Vto7V 
AlRPUL VOltaGeS vec. yeh enne ee ie kere ee oO eee ee Ree eel ee -0.3Vto 15 V 
OUtputVOlidde: xs ee. esa tooo tebe eet eee ei oh ee he ee eee .. -0.3Vto 15 V 
Continuous power dissipation.................. ee ee ee ee ee ee eee 0.4 W 
Air temperature range above operating device ............ 0.0 ee ee es O°C to 70°C 
Storage temperature range ....... 0... cc ee ees -55°C to +150°C 


TStresses beyond those listed under ‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating 
only and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. | | 7 | 

+All voltage values are with respect to Vss. 


recommended operating conditions 3 | 


Vcc Supply voltage | 4.5 5 5.5 
Vs Supply voltage ao 


v biel pases eee baia a toe All inputs except CLKIN r 
igh-level in 
IH oe g CLKIN : 2.8 


















Vit Low-level input voltage (all inputs) | | FBT OV 
lOH High-level output current (all outputs) | 
lOL Low-level output current (all outputs) 


TA Operating free-air temperature , | 0 


NOTE 1. For dual-in-line package: 
ReajA = 51.6°C/Watt 
Rejc = 16.6°C/Watt. 
For plastic chip-carrier package: 
ReJA = 70°C/Watt 
Reic = 20°C/Watt. 
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electrical characteristics over specified temperature range (unless otherwise noted) 


PARAMETER TEST CONDITIONS MIN TYP? MAX | UNIT 
VOH High-level output voltage | low = MAX 
= 0 
2 
2 
2 











VOL Low-level output voltage lol = MAX 


| Off-state output t V MAX | Vo = 24V ae Moree 
-State output curren = 
Oz ) P : ce Vo = 0.4V — 20 


3 
20 
20 
| Data bus 
5 
0 








f = 1 MHz, 










All other pins O V 





| — 
cc? Supply current TA = 0°C 
C Output ca ita pele Pus 
utpu acitance 
. v All others 


TAII typical values except for I¢c are at Vcc = 5 V, Ta = 25°C. 
tIcc characteristics are inversely proportional to temperature; i.e., |Icc decreases approximately linearly with temperature. 
8Value derived from characterization data and not tested. 








CLOCK CHARACTERISTICS AND TIMING 
The TMS320C10 can use either its internal oscillator or an external frequency source for a clock. 


internal clock option 


The internal oscillator is enabled by connecting a crystal across X1 and X2/CLKIN (see Figure 1). The 
frequency of CLKOUT is one-fourth the crystal fundamental frequency. The crystal should be fundamental 
mode, and parallel resonant, with an effective series resistance of 30 ohms, a power dissipation of 1 mW, 
and be specified at a load capacitance of 20 pF. | | 


PARAMETER 


Crystal frequency f, O°C — 70°C 6.7 
C1, C2 0°C - 70°C 





; ANE ; 
tT . 


FIGURE 1. INTERNAL CLOCK OPTION 
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external clock option 


An external frequency source can be used by injecting the frequency directly into X2/CLKIN with X1 left 
unconnected. The external frequency injected must conform to the specifications listed in the table below. 


timing requirements over recommended operating conditions 


——————— UNIT 
te(MC) Master clock cycle time 48.78 150 | ons 
tric) Rise time master lock input fee ee HO ed 
ifuic) Fall time master clock input PSO os 















tw(MCP) Pulse duration master clock 047g) Sikes 
- tw(MCL) Pulse duration master clock low, teiymc) = 50 ns | | feelin 
tw(MCH Pulse duration master clock high, tec) = 50 ns 


switching characteristics over recommended operating conditions 


PARAMETER TEST CONDITIONS | MIN NOM Max, 


tcic) | CLKOUT cycle time! 
triC) CLKOUT rise time 
















Ru = 82502 
t#(C) CLKOUT fall time Cy = 100 pF 
twiCL) Pulse duration, CLKOUT low See Figure - 





tw(CH) Pulse duration, CLKOUT high 
ta(mcc) Delay time CLKIN1 to CLKOUTL? © 


Tteie) is the cycle time of CLKOUT, i.e., 4* toiMC) (4 times CLKIN cycle time if an external oscillator is used). 
Values given were derived from characterization data and are not tested. 
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PARAMETER MEASUREMENT INFORMATION 


2.15 V 


Ri = 8250 


FROM OUTPUT 


UNDER TEST TEST 
POINT 


T° = 100 pF 


FIGURE 2. TEST LOAD CIRCUIT 







——<— <= = ——— Ving (MIN) 


= Vi (MAX) 


(a) INPUT 





(b) OUTPUTS 


FIGURE 3. VOLTAGE REFERENCE LEVELS 
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clock timing | 


—P| (© trmc) | : —_—* tw(MCH) — | 
| \¢——— cmc) —> | ‘¢ . twimcp)! 


: | | | 
| I | | 
le—_——p}- tw(MCL) — _ 


i 
1 Mc) pl lee | | | ’ 
lo—p,- t | SS wich 
d(MCC) i | 


| - 
| 7 


| 
+ le— 4(C) | | —>| pe tric) | 
| . | 





NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
Ttaimcc) and tw(MCP) are referenced to an intermediate level of 1.5 volts on the CLKIN waveform. 


MEMORY AND PERIPHERAL INTERFACE TIMING 


switching characteristics over recommended operating conditions 


| TEST 
MIN TYP MAX i 
Del 
; elay time SEOr ts to | 1ot 50 
address bus valid (see Note 4) : 
15 
15 
15 














Yatc(C) 5t Vatc(c) + 15 





Vatc(C) 5T Yatce(c) + 15 


t Delay time CLKOUTS to MENI Vate(c)— 51 Vatg(c)t15 | ons 
t Delay time CLKOUT! to MENT | ons | 
ee 


dt 
d2 
43 3 MEN 
td4 Delay time CLKOUT{ to DEN 
td5 Delay time CLKOUT! to DENT 
ta6 i WE 
d7 
d8 | 
9 5 


Delay time CLKOUT! to WE! 
t Delay time CLKOUT! to WET 
t 


Delay time CLKOUT to 

Time after CLKOUT! that data 

Time after CLKOUT) that data | 
'd10 bus stops being driven 


ty .-—s«éD atta. buss OUT valid after CLKOUTJ Vatg(c) - 10 


NOTE 3: Address bus will be valid upon WET, DENT, or MENT. | 
tThese values were derived from characterization data and are not tested. 


RL = 8250, © 
Cy = 100 pF, 
See Figure 2 












Yato(c) + 65 
Yateic)- 51 


Yatg(c) + 30 t 


timing requirements over recommended operating conditions 


TEST 
CONDITIONS 
tsu(D) Setup time data bus valid prior to CLKOUT! RL = 8250, 


tsu(A-MD) Address bus setup time prior to MEN! or DEN! C_ = 100 pF, 
See Figure 2 


th(D) Hold time data bus held valid after CLKOUT! 


NOTE 4: Data may be removed from the data bus upon MENT or DENT preceding CLKOUT). 


| 4 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 @ HOUSTON, TEXAS 77001 














C-14 


LOOLZ SWX31L ‘NOLSNOH @ Evtvl XOE 390Id40 LSOd 


l 


SINAWNAULSN 


tie SVX4[ 


GL-O 


peal: Arowoaw 


See tc(C) —_—_——_____—__——-#J 


CLKOUT \ / \ / 
ta2 a a 
ta3 7 ke : | 
le aes = I tsu(A-MD). | 
AAA XK YX AWAAAAAAAAAAAAAAAAS 
A11-A0 QAR ADDRESS BUS VALID OAK RXXAXKXXAK RL RK 
YY YY | YY YY YAY YAY 
= tsu(D) thiD) 
D15-D0 INSTRUCTION IN VALID 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


Ss 
m 
2 





YOSSII0Ud TWNDIS TWLIDIC 


OLIOCESINI 


LOOZLZ SVX3L ‘NOLSNOH @ evel XO@ JdIdd0 LSOd 


9L-9 


CLKOUT 


Ss 
m 
2 


> A11-A0 
hs 

aa 

<5 - D15-D0 
rr ; 

al 


LEGEND: 


TBLR INSTRUCTION PREFETCH 
DUMMY PREFETCH 

DATA FETCH 

NEXT INSTRUCTION PREFETCH 
ADDRESS BUS VALID 

6. ADDRESS BUS VALID 


oF ee us = 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


7. 
8. 
og: 
10. 
11. 
12. 


td3 


ADDRESS BUS VALID 
ADDRESS BUS VALID 
INSTRUCTION IN VALID 
INSTRUCTION IN VALID 
DATA IN VALID 
INSTRUCTION IN VALID 





Bulwiy uoHoNsU! YTgL 


YOSSII0Hd TWNDIS TVLIDIG 


OLD0ZESWL 


LOOLZ SVX3L ‘NOLSNOH e@ Evbl XO8 3DIdd0 LSOd 


SINAWNALSN 


(ye SVX4[ 





LL-9 


CLKOUT 


Ss 
m 
2 


A11-A0 


D15-D0 





LEGEND: 


2 OY ee 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


TBLW INSTRUCTION PREFETCH 
DUMMY PREFETCH 

NEXT INSTRUCTION PREFETCH 
ADDRESS BUS VALID 
ADDRESS BUS VALID 
ADDRESS BUS VALID 


7. 
8. 
9. 
10. 
11. 


ADDRESS BUS VALID 
INSTRUCTION IN VALID 
INSTRUCTION IN VALID 
DATA OUT VALID 
INSTRUCTION IN VALID 


Buu UONDNAYSU! AATE_L 


dOSSII0dd IWNOIS IVLIDIC 


OLIOZESWL 


8L-9 


VT FNL TDN 


5 
m 
2 


(AAA) CAAA \AAAAAAA/ CAAA) 
XXX) XX KN OXXKXX XX) 4.00.65 
WY WY NYYYYYYY | CLYYY 


= ee ete | 
DEN | | , 


Pe bee 


dy SVX4]_ 
| 


LOOZZ SVX3L NOLSNOH @® €vrl XO 3dis40 LSOd 
SINANNUYULSN 





D15-DO 


LEGEND: 


ADDRESS BUS VALID 
INSTRUCTION IN VALID 
DATA IN VALID 
INSTRUCTION IN VALID 


1. IN INSTRUCTION PREFETCH 
2. NEXT INSTRUCTION PREFETCH 
3. ADDRESS BUS VALID 

4. PERIPHERAL ADDRESS VALID 


ea od 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


“Burn UO!ILONAJSU! Aj] 


OLIOZESWL 


YOSSII0Ud TVNSIS IVLISIC 


LOOLL SVX3L ‘NOLSNOH @ €¢bl XO 3DId4O 1SOd 


l 


SLINAWNUYLSN 


6L-9 


CLKOUT 


(ye SVX]. . 





MEN 
A11-A0 

WE 
D15-DO 

LEGEND: 

1. OUT INSTRUCTION PREFETCH 5. | ADDRESS BUS VALID 

2. NEXT INSTRUCTION PREFETCH 6. | INSTRUCTION IN VALID 

3. | ADDRESS BUS VALID 7. DATA OUT VALID 

4. PERIPHERAL ADDRESS VALID 8. INSTRUCTION IN VALID 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
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RESET (RS) TIMING 


timing requirements over recommended operating conditions 


TH 


tsu(R) Reset (RS) setup time prior to CLKOUT. See Note 5. ee 
tw(R) RS pulse duration Stc(C) | ited 


switching characteristics over recommended operating conditions — 


TEST 
PARAMETER 
CONDITIONS Pees ae 


tq11 | tai Delay time DENT, WEt, and MENT from RS time DENT, WET, and MENT from RS = 825 0, Hate) +50] ons 


es 100 pF, 
tdis(R) Data bus disable time after RS | eo ee al 


See Figure 2 
NOTE 5: RS can occur anytime during a clock cycle. Time given is minimum to ensure synchronous operation. 
tThese values were derived from characterization data and are not tested. 




















reset timing 


td11 


tdis(R) be 


D15-DO DATA : /DATA IN FROM DATA IN FROM 
OUT. PC ADDR 0 PC ADDR PC +1 
DATA SHOWN RELATIVE TO WE £ : 


= ADDRESS BUS 


ADDRESS 


NOTES: — 2. Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise 
| noted. 


6. RS forces DEN, WE, and MEN high and tristates data bus DO through D15. AB outputs (and program counter) are synchronously 
_ Cleared to zero after the next complete CLK cycle from URS. 


DEN | Se 
WE SEE a | 
MEN NOTE 10 | OE 


7. RS must be maintained for a minimum of five clock cycles. 
. Resumption of normal program will commence after one complete CLK cycle from TRS. 
9. Due to the synchronizing action on RS, time to execute the function can vary dependent upon when tRS or , RS occur in 
| the CLK cycle. 
10. Diagram shown is for definition purpose only. DEN, WE, and MEN are rautually exclusive. 
11. During a write cycle, RS may produce an invalid write address. 


© 
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INTERRUPT (INT) TIMING 


timing requirements over recommended operating conditions : 7 


nt ox [unt 














tsu(INT Setup time INT! before CLKOUT! 





interrupt timing 


[eof sain 


INT K / 
t(INT) —p 
eeeconona 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 


1/O (BIO) TIMING 


timing requirements over recommended operating conditions 


tsu(lO Setup time BIO! before CLKOUTJ 




















BIO timing 


CLKOUT Jf “Jf \K J Xx 
— tsu(IO) 
a fee ee 
#10) je | 
ee 


NOTE 2: Timing measurements are referenced to and from a low voltage of 0.8 volts and a high voltage of 2.0 volts, unless otherwise noted. 
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THERMAL DATA 


thermal resistance characteristics 


R R 
PACKAGE salis we 
(°C/W) | (°C/W) 
40-pin plastic dual-in-line package 51.6 16.6 
44-lead plastic chip carrier package , | 


MECHANICAL DATA 





40-pin plastic dual-in-line package 


53,1 (2.090) MAX 


EITHER OR BOTH 
INDEX MARKS 


€ 145,24+0,25 © 
(0.600 + 0.010) 0.51 ee : 5,08 (0.200) MAX 


Toe 
SrA 
ze bememmn VV VY YY YYYYYY YY YY tt 
a 28+0,08 aa 0,457 + 0,076 —>{ ke 

(0.011+0.003) (0.018 + 0.003) 0,84 (0.033) ol 


PIN SPACING 2,54 (0.100) T.P. 
(SEE NOTE A) 1,52 (0.060) eke 


2,92 (0.115) MIN 


ee esos 41 (0.095) 
1,40 (0.055) 


ALL DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 





NOTE A: Each pin centerline is located within 0,254 (0.010) of its true longitudinal position. 
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44-lead plastic chip carrier package 


17,65 (0.695) 
17,40 (0.685) 


16,66 (0.656) 
16,51 (0.650) 





17,65 (0.695) 
17,40 (0.685) 


16,66 (0.656) 
16,51 (0.650) 


4,57 (0.180) 
4,19 (0.165) 


3,05 (0.120) 
2,29 (0.090) 







TYP 0,51 (0.020) 
MIN 


0,533 (0.021) } | 


0,330 (0.013) 
16,00 (0.630) 
14,99 (0.590) 
1,27 (0.050) 


TYP 





ALL DIMENSIONS ARE IN MILLIMETERS AND PARENTHETICALLY IN INCHES 
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D. TMS32020/TMS320C25 System Migration 


This appendix contains information necessary to upgrade a TMS32020 program to 
a TMS320C25-based system. The information consists of a detailed list of the 
programming differences and hardware and timing differences between the two 
processors. The following items should be considered in migrating from the 
TMS32020 to the TMS320C25: 


1) 


2) 


3) 


4) 


5) 


6) 


7) 


8) 


9) 


Instructions are fully compatible at the object code level. TMS32020 object 
(memory image) code can be used directly on the TMS320C25 processor. 


Instructions are compatible at the source code level. The NORM instruction that 
previously had no operands now has an optional operand to define the auxiliary 
register modification. Any comments on the same line in the source code file 
will be interpreted as the operand if no other operand is specified. NORM 
instructions should be modified to specify the default operand, *+. 


Execution cycle timings of instructions have been modified. Most TMS320C25 
instructions execute in a single machine cycle. The number of cycles for some 
multicycle instructions have been changed. Refer to Appendix E for detailed 
information on instruction cycle timings. By following the entries in this 
appendix, the key timing differences can be noted. 


The IDLE instruction automatically sets the INTM bit in status register STO to 
a zero. This assures that an external interrupt will ‘wake up’ the processor. The 
instruction also requires three memory cycles to execute on the TMS320C25 
rather than one as on the TMS32020. 


In general, all branch, call, and return instructions that reload the program 
counter (PC) should be counted as three-cycle instructions when evaluating 
code execution timings on the TMS320C25. 


The store instructions (SACH, SACL, etc.) execute in one less cycle on the 
TMS320C25 than on the TMS32020 when data is stored to external data 
memory. | 


The MAC and MACD instructions require one extra cycle, going from three to 
four cycles. The extra cycle is in the instruction read and setup overhead, and 
repeated execution will be one cycle per execution as on the TMS32020. 


The delay for a new memory configuration to become effective when using the 
CNFD or CNFP instructions on the TMS320C25 is two instruction fetches (for 
single-cycle instructions) when executing from external memory or internal 
ROM, as compared to one instruction fetch for the TMS32020. Thus, on the 
TMS320C25, a CNFP instruction must be placed at location 65277 if execution 
is to continue from the first location in block BO. When execution is from internal 
RAM on the TMS320C25, however, this delay is one instruction fetch as on 
the TMS32020. 


The timer on the TMS320C25 is clocked by CLKOUT1 and counts PRD + 1 
CLKOUT1 cycles, whereas the timer on the TMS32020 is clocked by 
CLKOUT1/4 and counts 4 x PRD cycles. Therefore, to count an equivalent 
amount of time on the TMS320C25 using the same input clock frequency, PRD 
values from the TMS32020 must first be multiplied by four and then decre- 
mented by one. If different input clock frequencies are used, this must also be 
accounted for by multiplying the PRD value for the TMS320C25 obtained above 
by the ratio of the TMS320C25 input clock frequency to the TMS32020 input 
clock frequency. 
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On the TMS320C25, both the timer (TIM) and period (PRD) registers are 


- initialized to >FFFF on reset, while on the TMS32020, only the TIM register is 


initialized. 


Several bits (C, HM, and FSM) have been added to status register ST1 on the 
TMS320C25, as shown below. 


| TMS32020 Status Register ST1 

15 14 13 12 1110 9 8 4 3 2 1 
Cane Jone re Baw 1 [aero a 
| 'TMS320€25 Status Register ST1: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 #1 


ane Tener Beno [11 Jaws xe] Fo Fw 


‘The FSM, HM, and C status register bits are initialized by reset and are all set 


to one when reset occurs. Note that the new bits are assigned polarities in such 
a way that the values of the corresponding bits on the TMS32020 invoke a 
TMS32020-like operation on the TMS320C25. 


The SXM and PM status register bits that were previously uninitialized on the 
TMS32020 are now initialized by reset on the TMS320C25. When the 


~ TMS320C25 is reset, SXM is set to one, and the PM bits are set to zero. 
12) 


There are four differences between the serial ports on the TMS32020 and 
TMS320C25 that impact system migration. The two major differences are that 
the serial port on the TMS320C25 is double-buffered and is fully static in 
operation. Double-buffering greatly increases the amount of time available for 
processing serial port interrupts. Fully static operation effectively places no 
lower limit on serial port clock frequency. Neither of these features is present 
on the TMS32020. 


Another difference in serial port operation between the two processors is that 


serial port interrupts are generated half of a CLKR or CLKX cycle later on the 


TMS320C25 than they are on the TMS32020. Specifically, on the TMS32020, 
RINT and XINT are generated on the falling edge of CLKR and CLKX, respec- 
tively, during transfer of the last bit. On the TMS320C25, RINT and XINT are 
generated on the rising edge of CLKR or CLKX after the last bit has been 
transferred. This should not be critical for TMS32020 programs running on the 
TMS320C25 since double-buffering of the serial port on the TMS320C25 
allows more time for processing of serial port interrupts. Some modification of 
TMS32020 programs may, however, be required to take advantage of the 
double-buffering, depending on how serial port interrupt servicing is imple- 
mented. 


Finally, when operating the TMS320C25 serial port in byte mode, DRR behaves 
differently than it does on the TMS32020. On the TMS32020, the contents of 
the most significant byte of DRR remain unchanged once byte mode is initiated 
by executing a FORT instruction. On the TMS320C25, however, each time a 
new byte is received, the previous contents of the least significant byte of DRR 


are transferred to the most significant byte of DRR. Figure D-1 illustrates the 


_ behavior of DRR on both the TMS32020 and the TMS320C25 processors. 
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TMS320C25 TMS32020 


MSB LSB MSB LSB 
Initial 
Conditions 


After 1st Receive 
(Byte ‘A’) 


After 2nd Receive 
(Byte ‘B’) 


Etc. 


Figure D-1. Serial Port System Migration 
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E. TMS320C25 Instruction Cycle Timings 


This appendix details the instruction cycle timings for the TMS320C25. Table E-1 
lists the instructions according to cycle classification. 


Table E-1. TMS320C25 Instructions by Cycle Class 
















SUBS SUBT XOR ZALH ZALR ZALS _ (RPT not repeatable) 


CLASS INSTRUCTION 
LAR LDP LST LST1 
POPD SACH SACL SAR SPH SPL SST SST1 


sy ADD ADDC ADDH ADDS ADDT AND _ BIT BITT DMOV LAC 
ABS ADDK ADRK APAC CMPL CMPR_- CNFD DINT  EINT 


LACT LPH LT LTA LTD LTP LTS MPY MPYA MPYS 
FORT LACK LARK LARP LDPK MAR MPYK NEG NOP NORM 
PAC POP PUSH RC RFSM RHM ROL ROR ROVM RPTK 
RSXM RTC RTXM RXF SBRK SC SFL SFR SFSM SHM 
SOVM SPAC SPM SSXM STC STXM SUBK SXF ZAC 

(ADDK, ADRK, LACK, LARK, LDPK, MPYK, RPTK, SBRK, SPM, 

SUBK, and ZAC not repeatable) 








MPYU PSHD OR RPT SQRA SQRS- SUB SUBB SUBC SUBH 
ADLK ANDK LALK LRLK ORK SBLK XORK 
(All not repeatable) 


MAC MACD 


BANZ BBNZ_ BBZ BC BGEZ BGZ BIOZ BLEZ BLZ BNC 
BNV BNZ BV BZ (All not repeatable) , 


Vill B BACC CALA CALL RET TRAP 
(All not repeatable) : 





IV 
V 
VE 
vil 

TBLA 

TBLW (Table in ROM not applicable) 






Xitl BLKD | 


BLKP 
IDLE 


E-1 


- Appendix E 


| Table E-2 and Table E-3 show the number of cycles required for a given TMS320C25 
instruction to execute in a given memory configuration. The column. headings in the 
tables indicate the program source location and data destination or source. 


The number of cycles required for each instruction is given in terms of the 
program/data memory and I/O access times as defined in the following listing: 


p - Program memory wait states. Represents the number of clock cycles the 
device waits for external program memory to respond to an access. Tag Is 
the access time, in nanoseconds, (maximum) required by the TMS320C25 
for an external memory access to be made with no wait states. Tmem is the 
memory device access time, and Tp is the clock period (4/crystal 


frequency). 
p = 0; If Tmem s Tac 
p=1, If Tac < Tmem < (Tp + Tae) 
p= 2; If (Tp + Tac)< icc <.(Tp x 2 + Tac) 
p=k; lf ie x (k-1) + Tac]< T mem s (Tp x k + Tac) 
d - Data memory wait states. Represents the number of cycles the device must 


wait for external data memory to respond to an access. This number is 
calculated in the same way as the p number. 


ae 1/0 memory wait states. Represents the number of cycles the device must 
wait for external |1/O memory to respond to an access. This number is 
calculated in the same way as the p number. 


The other abbreviations used in the tables and their meanings are as follows: 


Pl - The instruction executes from internal program memory (RAM). 

PR - The instruction executes from internal program memory (ROM). 

PE - | The instruction executes from external program memory. 

DI - The instruction executes using internal data memory. 

DE - The instruction executes using external data memory. 

INT - Interrupt. 

n - The number of times an instruction is executed when using the RPT or 


RPTK instruction. 


Table E-2. Cycle Timings for Cycle Classes When Not in Repeat Mode 


CLASS PI/DI — PE/DI PE/DE —— —— 
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Table E-2. Cycle Timings for Cycle Classes When Not in Repeat Mode (Concluded) 














Vi Table is in on-chip RAM: 
3 4+d 5+d+2p 4 5+d 
Table is in on-chip ROM: 
4 5+d 5+d+2p 
Table is in external memory: 
4+p 5+d+p 5+d+3p 
Vil True Conditions: 
Destination is on-chip RAM: 
2 
Destination is on-chip ROM: 
3 
Destination is external memory: 
3+p 
False Condition: 
Destination is anywhere: 
Vit Destination is on-chip RAM: 
2 
Destination is on-chip ROM: 
3 
. Destination is external memory: 
3+p 3+p 
2+i 2+d+i 2+pti 3+d+pti 2+i 2+d+i 
1 +i 2+d+i 2+pti 3+d+pti 1+i 2+d+i 
Xl Table is in on-chip RAM: 
2 2+d 3t+d+p 
Table is in on-chip ROM: 
3 3+d 4+d+p 
Table is in external memory: 
3+p 3+d+p 4+d+2p 
XII Table is in on-chip RAM: 
2 3+d 3+p 4+d+p 
Table is in on-chip ROM: 
not applicable 
Table is in external memory: 
2+p 3+d+p 3+2p 4+d+2p 
Xi Source data Is in on-chip RAM: 
3 3+d 3+2p 3t+d+2p 
Source data is in external memory: 
4+d 4+2d 4+d+2p 4+2d+2p 
XIV Table is in on-chip RAM: 
3 3+d 4+d+2p 
Table is in on-chip ROM: 
4 4+d 4+d+2p 
Table is in external memory: 
4+p 4+d+p _ 4+d+3p 
XV 





(Interrupt) destination is on-chip ROM 
3 (minimum waits for INT) 
(Interrupt) destination is external memory 
3+2p (minimum waits for INT) 
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Table E-3. Cycle Timings for Cycle Classes When in Repeat Mode 


Pt nd tentnd font tenendep [on | denen] 
A 
nnd tp trent [nd nnd 

No OO —~*™Y 


not repeatable 






Table is in on-chip RAM: 
2+n 2+2n+nd 3+n+2p 3+2n+nd+2p 3+n 3+2n+nd 






Table is in on-chip ROM: | | 
3+n 3+2nt+nd 3t+nt+2p 3+2n+nd+2p 3+n 3+2n+nd 






Table is in external memory: 
3+n+t+np 3+2nt+ndt+tnp 3+n+np+2p 3+2n+nd+np+2p 3+n+np 3+2n+nd+np 


Vil not repeatable 
Vl not repeatable | 


1+ntni — 2n+nd+ni 1+n+ptni 1+2n+nd+ptni 1+n+ni 2n+ndtni 
n+ni 2n+nd+ni T+n+ptni 1+2n+nd+ptni n+nit+ni 2n+nd+ni 


Table is in on-chip RAM: 
T+n 1+n+nd 2+n+p 2+n+nd+p 2+n+nd 











x< 





Table is in on-chip ROM: 
2+n 2+n+nd 3+n+p 3+n+nd+p 3+n 3+nt+nd 


Table is in external memory: 
2+n+np 1+2n+nd+np 3+nt+nptp 2+2n+ndt+npt+p 3+nt+np 2+2n+nd+np 


XII Table is in on-chip RAM: 
1+n 2+n+nd 2+n+p 3+nt+nd+p 


Table is in on-chip ROM: 
? not applicable 


Table is in external memory: 
1T+n+np 1+2n+nd+np 2+n+np+p 2+2n+nd+npt+p 2+2n+nd+np 


Xl Source data is in on-chip RAM: : 
2+n 2+n+nd 2+n+2p 2+n+nd+2p 2+n 2+n+nd 
Source data is in external memory: 
3+n+nd 2+2n+2nd 3+nt+nd+2p 2+2n+2nd+2p 3+n+nd 2+2n+2nd 


XIV Table is in on-chip RAM: 
2+n 2+nt+nd 3+n+2p 3+nt+nd+2p 3+n+nd 





Table is in on-chip ROM: 
3+n 3+n+nd 3+n+2p 3+n+nd+2p 3+n 3+nt+nd 


Table is in external memory: 
3+n+np 2+2nt+tnd+np 3+n+npt+2p 2+2nt+nd+np+2p 3+n+np 2+2n+nd+np 


not repeatable 





~< 


E-4 


F. TMS320C25 Development Support/Part 
Order Information 


Texas Instruments offers extensive development support and complete documenta- 
tion with the TMS320 family of digital signal processors (see Figure F-1). Tools are 
provided to evaluate the performance of the processor, develop algorithm imple- 
mentations, and fully integrate the design’s software and hardware modules. 


The development support available for the TMS320C25 is listed below. 
@ Macro Assembler/Linker 
® Simulator 


@ Emulator (XDS/22) 


Key features, a description, and part order information for each TMS320C25 devel- 
opment support tool can be found in the following pages. Contact the nearest TI field 
sales office for availability or further details (see list of sales offices and distributors 
at end of book). 





Figure F-1. TMS320 Family Development Support 
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F.1 TMS320C25 Macro Assembler/Linker 


The. TMS320C25 Macro Assembler translates TMS320C25. assembly language 


source code into executable object code. The assembler allows the programmer to 
_ work with mnemonics rather than hexadecimal machine instructions and to reference 


memory locations with symbolic addresses. The macro assembler supports macro 
calls and definitions along with conditional assembly. 


The TMS320C25 Linker permits a program to be designed and implemented in 
separate modules that will later be linked together to form the compiete program. 
The linker resolves external definitions and references for relocatable code, creating 
an object file that can be executed by the TMS320C25 Simulator, TMS320C25 
Emulators, or TMS320C25 processor. 


The following key features distinguish the TMS320C25 Macro Assembler/Linker: 


Macro Capabilities and Library Functions 
Conditional Assembly 

Relocatable Modules 

Complete Error Diagnostics 

Symbol Table and Cross Reference 


The TMS320C25 Macro Assembler/Linker is currently available for the VAX/VMS, 
Tl PC/MS-DOS, and IBM PC/PC-DOS operating systems. 


HOST | OPERATING PART NUMBER MEDIUM 
SYSTEM 
DEC VAX VMS ~T TMDS3242210-08 1600 BP] MAG TAPE 
TI/IBM PC MS/PC-DOS TMDS$3242810-02 5 1/4" FLOPPY 



















F.2 TMS320C25 Simulator 


The TMS320C25 Simulator is a software program that simulates operation of the 
TMS320C25 to allow program verification. The debug mode enables the user to 
monitor the state of the simulated TMS320C25 while the program is executing. The 
simulator uses the TMS320C25 object code produced by the TMS320C25 Macro 
Assembler/Linker. During program execution, the internal registers and memory of 


the simulated TMS320C25 are modified as each instruction is interpreted by the host 


computer. Once program execution is suspended, the internal registers and both 
program and data memories can be inspected and/or modified. In addition, files can 
be associated with the !|/O ports. 


The following features highlight simulator capability for effective TMS320C25 soft- 
ware development: 


Program Debug/Verification 

Single-Step Option _ 

Trace/Breakpoint Capabilities 

Full Access to Simulated Registers and Memories 
1/O Device Simulation | 


The TMS320C25 Simulator is currently available for the VAX/VMS, Tl PC/MS-DOS, 


~ and IBM PC/PC-DOS operating systems. 
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HOST OPERATING PART NUMBER 
: SYSTEM | | 


DEC VAX VMS TMDS3242211-08 1600 BP| MAG TAPE 


TI/IBM PC MS/PC-DOS TMDS3242811-02 5 1/4" FLOPPY 
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F.3 TMS320C25 Emulator 


The TMS320C25 Emulator (XDS/22) is a user-friendly system that has all the 
features necessary for realtime in-circuit emulation. This allows integration of hard- 
ware and software modules in the debug mode. By setting breakpoints based on 
internal conditions or external events, execution of the program can be suspended 
and control given to the debug mode. In the debug mode, all registers and memory 
locations can be inspected and modified. Single-step execution is available. Full- 
trace capabilities at full speed and a reverse assembler that translates machine code 
back into assembly instructions also increase debugging productivity. Using a 
standard RS-232-C port, the object file produced by the TMS320C25 Macro 
Assembler/Linker can be downloaded into the emulator, which then can be 
controlled through a terminal. 


The XDS/22 provides 4K x 16 words of high-speed static RAM (zero wait states) 
for program memory and sockets for 4K x 16 words of high-speed static RAM for 
user-supplied data memory. It also has the capability of executing out of target 
memory to utilize the full TMS320C25 program/data address range. For multiproc- 
essing configurations, up to nine emulators can be daisy-chained together. 


The XDS/22 emulator is a completely self-contained system with power supply. This 
model also includes memory expansion with 64K x 16 words of DRAM (two wait 
states). This slower memory is configurable by the user as either all program memory, 
all data memory, or 32K words of each. With three RS-232-C ports, the XDS/22 
Emulator can be interfaced to a terminal, host computer for source or object 
downloading/uploading capabilities, and printer or PROM programmer. 


The key features of the XDS/22 Emulator are as follows: 


Full-Speed In-Circuit Emulation 

4K Words of Program Memory for User Code 

Program/Data DRAM Memory Expansion to 64K Words 

Hardware Breakpoint on Program, Data, or |/O Conditions 

2K Words of Full-Speed Hardware Trace 

Use of Target System Crystal, Internal Crystal, or External Clock Signal 
Up to Ten Software Breakpoints 

Single-Step Option 

Assembler/Reverse Assembler 

Host-Independent Upload/Download Capabilities to/from Program or Data 
Memory 

Ability to Inspect and Modify Registers and Program/Data Memory 
Multiprocessor System Development 


MODEL PART NUMBER POWER SUPPLY — 
XDS/22 TMDS3262221 (Included) _ 


Figure F-2 shows a block diagram of a typical system configuration using the 
TMS320C25 XDS/22 Emulator. 
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Figure F-2. TMS320C25 XDS/22 Emulator System Configuration 
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To provide expeditious system evaluations by customers during the product devel- 
opment cycle, Texas Instruments assigns a prefix designator with three options: TMX, 
TMP, and TMS. These prefixes are representative of the evolutionary stages of 
product development from engineering prototypes (TMX) through fully qualified 
production devices (TMS). This evolutionary development flow is defined below. 


TMX Experimental devices that are not representative of the final device's 
electrical specifications. 


TMP Final silicon die that conforms to the device’s electrical specifications 
but has not completed quality and reliability verification. 


TMS Fully qualified production devices. 


TMX devices are shipped against the following disclaimer: 
1) Product ts experimental and its reliability has not been characterized. 
2) Product is sold "as is.” 


3) Product is not warranted to be exemplary of final production version if or when 
released by Texas Instruments. 


TMP devices are shipped against the following disclaimer: 
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1) Customer understands that the product purchased hereunder has not been fully 
characterized and the expectation of quality and reliability cannot be defined; 
therefore, Texas Instruments standard warranty refers only to the device’s 
specifications. 


2) No warranty of merchantability or fitness is expressed or implied. 


Note: 


Texas Instruments recommends that prototype devices (TMX or TMP) not be 


used in production systems since their expected end-use failure rate is undefined 
but predicted to be greater than standard qualified production devices. 





TMS devices have been fully characterized and the quality and reliability of the device 
has been fully demonstrated. Texas Instruments standard warranty applies. 


F.5 TMS320 Nomenclature 
In addition to the prefix, the device family name, the specific device name, package 


type, and temperature range are designated in the device nomenclature. Figure F-3 
provides a legend for reading the complete device name. 


TMS 320 C 25 FN L 


PREFIX | | TEMPERATURE RANGE 





TMS = standard prefix L = O°C to 70°C 

SMJ = MIL-STD-883C S = -55°C to 100°C 
M = -58°C to 125°C 
A = -40°C to 85°C 

FAMILY 

320 = signal processing family PACKAGE TYPE 


N = plastic DIP 

JD = ceramic DIP side—-brazed 
FN = plastic leaded CC 

GB = ceramic PGA 

FJ = ceramic leaded CC 

FD = leadiless ceramic CC 





TECHNOLOGY 
C = CMOS 





DEVICE 
10 = 1Ist-generation microprocessor/microcomputer 


a = 2nd-generation microprocessor 


Figure F-3. TMS320 Nomenclature 
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G. TMS320C25 Macro Assembler and Link 


1 


2 


Editor Installation 


This appendix contains step-by-step instructions for installing, verifying, and 
relinking the TMS320C25 Macro Assembler and Link Editor. This software can be 
installed on two operating systems: 


@ VAX/VMS (Digital Equipment Corporation VAX-11)! 
@ MS/PC-DOS (MS-DOS for the Tl PC and PC-DOS for the IBM PC)2 


The following style and symbol conventions are used to present information clearly 
and concisely: 


@ The symbol <CR> indicates that a carriage return should be entered. 
@ Screen displays are shown in a special font. 
@ Portions of a display that are user responses are underscored. 


VAX-11 and VMS are trademarks of Digital Equipment Corporation. 


PC-DOS is a trademark of International Business Machines. 
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G.1 TMS320C25 VAX/VMS CrossWare Installation 


The TMS320C25 CrossWare tape was ereated with ‘he VMS BACKUP sieiniey: The 
package is contained in two directories, shipped in two save-sets. 


In the examples, replace <directory> with the name of the discion in which this 
package resides, e.g., DUA2:[DSP. ASM25]. Note the use of brackets in this section 
to indicate a directory. | 


The following subsections include the sequence of steps used for restoring the 
directories of the Macro Assembler and Link Editor, installing command files, 
providing transparent access, verifying the installation procedure, and relinking the 
product components. A list of the product directories is also provided. 


G.1.1 Restoring the Distribution Tape to Disk 


G-2 


In the following examples, MFAO i is the tape drive name and DUA2 is the hard disk 
drive name. The tape drive and disk drive may have other names, dependent on a 
particular system. 


Mount the Tape 


Place the tape on a tape drive. Mount it by entering: 


ALLOC MFAO: <CR> 
MOUNT MFAO: /OVER=ID/FOR/DEN=1600 <CR> 


If the mount is successful, the screen displays: 








ASM25 MOUNTED ON MFAO 

Restore the Macro Assembler 

Use the BACKUP utility to read the C25ASM save-set from the tape: 
BACKUP/LOG/VERIFY MFAO:C25ASM.BCK DUA2: [<directory>]*.* <CR> 


The CrossWare package can reside in either the user directory or a system 
directory. The examples copy the package into the user directory, copying the 
C25ASM.BCK directory structure on the tape into [<directory>] on disk DUA2. 


A README file explaining the Macro Assembler validation procedure is 
contained in this directory: 


[<directory>.C25ASM] README .DAT 

If not installing the Link Editor, skip the next step and unload the tape. 
Restore the Link Editor 

Use the BACKUP utility to copy the LINKER save-set from the tape: 


BACKUP/LOG/VERIFY MFAO:LINKER.BCK DUA2: [<directory>]*.* <CR> 


The LINKER.BCK directory structure on the tape is copied into [<directory>] 
on disk DUAZ2. 


| A README file explaining the Link Editor validation procedure is contained in 


this directory: 


[<directory>.LINKER] README. DAT 
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Dismount the Tape 


Dismount the tape by entering: 


DISMOUNT MFAO: <CR> 


Remove the tape from the drive. Deallocate the tape drive by entering: 


DEALLOCATE MFAO: <CR> 





G.1.2 Installing Command Files 


Two command procedures are provided to ensure correct system-dependent parse 
features. If the VAX/VMS system runs under Version 2.5, use the PARSE.C25 
command procedure by renaming it PARSE.COM. If the system runs under Version 
3.0, use the default PARSE.COM. 


Set the default directory to the directory to which the Assembler and Linker have 
been restored. Edit the Assembler and Linker command files, replacing existing 
pathnames with the pathnames to which they have been restored: 


Edit the file: [<directory>.C25ASM] XASM.COM 


Insert the appropriate file pathnames in three places: 


For the two calls to the PARSE command, which appear within the first 
20 lines, insert the appropriate file pathname after @ and before PARSE: 


S @DUA2: [<directory>.C25ASM]PARSE 'P1' 


For the one RUN statement, which appears near the bottom of the file, 
insert the appropriate file pathname after RUN and before ASM32020: 


S$ RUN DUA2: [<directory>.C25ASM]ASM32020 


Edit the file. [<directory>.LINKER] XLINKER.COM 


Substitute the appropriate file pathnames in three places: 


Two calls to the PARSE command, marked in the file by a preceding line 
KEKEAKKKEK ' 


S$ @[MOORE.LINKER]PARSE 'Pl1' 


Change them to: 


$ @DUA2: [<directory>.LINKER]PARSE 'P1' 


One RUN statement near the end of the file. 


$ RUN[MOORE.LINKER] LINKER 


Change it to: 


S$ RUN DUA2: [<directory>.LINKER] LINKER 
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G.1.3 eT OMICING Transparent Access 


Use the following procedure to sipvide transparent access to eh Assembler and Link 
Editor for all users. After the directories are on disk, make the plewing assignments 
into the LOGIN.COM file: | 


$ X320 :== @DUA2: [<directory>.C25ASM] XASM.COM 
$ XLINK :== @DUA2:[<directory>.LINKER] XLINKER.COM 


This defines the X320 and XLINK commands, which execute the Macro Assembler 
and Link Editor. Execute the Macro Assembler by entering X320 at the terminal in 
System Mode. Similarly, execute the Link Editor by entering XLINK. 


G.1.4 Verifying Installation 


This verification procedure is not designed to perform an exhaustive test. It simply 
verifies that the installation procedures were executed correctly. It also provides 
familiarity with the basic operation and data flow of this package. 


The test procedure consists of creating a test directory, assembling three source files, 
and linking the assembler output files. 


1) Create a test directory. Copy the TEST.ASM, TEST1.ASM, TEST2.ASM, and 
TEST1.CON files from [.C25ASM] and [.LINKER] into the directory by entering 
these commands: 


CREATE/DIR [<userid>.TEST] <CR> 

SET DEF [<userid>.TEST] <CR> 

COPY - [<directory>. C25ASM]TEST. ASM * <CR> 
. {[<directory>.LINKER]TEST1.ASM * <CR> 
COPY [<directory>.LINKER]TEST2.ASM * <CR> 
COPY [<directory>.LINKER]TEST1.CON * 








DM 
Q 
cf 
ro|td 
Ke 











2) In System Mode, enter: X320 <CR> 
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For the first input parameter in each of the three assembler runs, enter 
TEST.ASM, TEST1.ASM, and TEST2.ASM, respectively (ASM is the default). 
The command procedure parses the pathname and generates defaults for the 
Output listing and object files. Press the carriage return to accept the defaults, 
or specify user file pathnames as follows: 

$ X320 TEST <CR> 

Object file (TEST.MPO): <CR> | 

Listing file (TEST.LIS): <CR> 

Messages (——TXE1:): <CR> 


$ X320 TEST1 

Object file (TEST1.MPO): <CR> 
Listing file (TEST1.LIS): <CR> 
Messages (——TXE1:): <CR> 


$ X320 TEST2 

Object file (TEST2.MPO): <CR> 
Listing file (TEST2.LIS): <CR> 
Messages (——TXE1:): <CR> 


This creates the TEST.MPO, TEST.LIS, TEST1.MPO, TEST1.LIS, TEST2.MPO 
and TEST2.LIS files in the directory [<userid>.TEST]. 














3) In System Mode, enter: XLINK <CR> 


As the first input parameter, enter TEST1.CON. For the second and third 
parameters, the command procedure parses the pathname and generates 
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defaults for the output, load, and map files. This procedure links the object files 
for TEST1 and TEST2 into a single executable object file in TEST1.LOD (CON 
is the default for the first parameter): 


S XLINK TEST1 <CR> 


Linked object file (TEST1.LOD): <CR> 
Map file (TEST1.MAP): <CR> | 


This creates the files TEST1.LO0D and TEST1.MAP. These files should agree 
with the precompiled versions in the product directories for the Macro Assem- 
bler and Link Editor. 





G.1.5 Relinking the Macro Assembler and Link Editor 


It should not be necessary to relink the Macro Assembler or Link Editor, but command 
files have been provided to allow for this contingency. 


To relink the Macro Assembler, edit the LINKASM.COM procedure file to put the 
correct pathname for the runtime library in the logical assignment statement. In 
System Mode, execute LINKASM.COM to relink the ASM32020.EXE file: 


S SET DEF [<directory>.C25ASM] <CR> 
$ @LINKASM <CR> — 


Similarly, to relink the Link Editor, edit the LINKLINK.COM procedure file to put the 
correct pathname for the runtime library in the logical assignment statement. In 
System Mode, execute LINKLINK.COM to relink the LINKER.EXE file: 


S SET DEF [<directory>.LINKER] <CR> 
S @LINKLINK <CR> : 


G.1.6 Product Directories 


The following listing contains the product directories found in the CrossWare pack- 
age. These two directories contain a total of 40 files. 


ET DEF [<userid>.<directory>] <CR> 
I <CR> 


1 


O 
ye) 





Directory [<directory>] 
C25ASM.DIR;1 LINKER.DIR;1 
Total: 2 files 


DIR [<directory>.C25ASM] <CR> 
Directory [<directory>.C25ASM] 


ASM.OBJ;1 ASM32020.EXE;1 ASMRTS.OLB;1 FORMO.ASM;1 
FORMO.LIS;1 FORMO.MPO;1 FORM1.ASM;1 FORM1.LIS;1 
FORM1.MPO;1 FORM2 .ASM;1 FORM2.LIS;1 FORM2 .MPO;1 
FORMREST.ASM;1 FORMREST.LIS;1 FORMREST.MPO;1 LINKASM.COM;1 
PARSE.C25;1 PARSE.COM;1 README .LIS;1 TEST.ASM;1 
TEST 2btoe lL TEST .MPO;1 > XASM.COM;1 


Total: 23 files 


DIR [<directory>.LINKER] <CR> 
Directory [<directory>.LINKER. ] 


XLINKER.COM;1 LINKER.EXE;1  #LINKER.OBJ;1 LINKLINK.COM;1 
| LINKRTS.OLB;1 PARSE.C25;1 PARSE .COM;1 README .LIS;1 

TEST1.ASM;1 TEST1.CON;1 . TEST1.LIS;1 TEST1.LOD;1 

TEST1.MAP;1 TEST1.MPO;1 _ TEST2 .ASM;1 TEST2.LIS;1 


- TEST2.MPO;1 
~~ Total: 17 files 
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G.2 TMS320C25 MS/PC- Dos CrossWare | 


The TMS320C25 CrossWare installation package is éoniainied on a dual-density 
double-sided floppy diskette. The Macro Assembler and Link Editor execute in batch 
mode on MS-DOS (TI PC) and PC-DOS (IBM PC) systems. At least 256K bytes 
of memory space must be available. 


Instructions are included for both hard-disk systems and dual floppy-drive systems. 
The examples use these symbols for drive names: 


A: 


B: 
E: 


Floppy- disk drive for hard- disk systems or source drive for dual floppy-drive 
systems. 


Destination or system disk drive for dual floppy-drive systems. 


Winchester (hard disk) for hard-disk systems. 


The following subsections include a list of the files on the diskette and the sequence 
of steps used for restoring, executing, and testing the directories of the Macro 
Assembler and Link Editor. 


G.2.1 Diskette Files 
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The TMS320C25 Assembler portion of the diskette contains four files: an 
executable module and three test files. | 


Executable Module: 


XASM.EXE — Executes the Macro Assembler 


Test Files: 
FFT.ASM Source file for Assembler test program 
FFT.LST Correct output listing file for Assembler test program 
FFT.MPO Correct output object file for Assembler test program 


The TMS320C25 Linker portion of the diskette contains ten files: one executable 
module and nine test files. 


Executable Module: | 
LINKER.EXE Executes the Link Editor 
Test Files: 


TST1.ASM Source file for test program #1 | 
TST1.LST. Correct output listing file for test program #1 
TST1.MPO Correct output object file for test program #1 
TST2.ASM Source file for test program #2 
TST2.LST Correct output listing file for test program #2 
TST2.MPO Correct output object file for test program #2 
LNKTST.CTL Linker test program (link control file) | 
_ LNKTST.MAP Correct output listing file for the Linker test program 
_ LNKTST.LOD Correct output object file for the Linker test program 
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G.2.2 Restoring the Macro Assembler and Linker 


Instructions are provided for hard-disk systems and dual floppy-drive systems. If 
using a dual floppy-drive system, the MS/PC-DOS system diskette should be in drive 


B. 
1) 


2) 


3) 


Make a backup diskette of the Macro Assembler and Linker. 


@ On MS-DOS, insert the source diskette in drive A. Enter: 
DISKCOPY A: A:/F/V <CR> 


The /F (format) switch tells MS-DOS to format the new (destination) 
diskette before copying begins. The /V (verify) switch tells MS-DOS to 
verify that the source and destination diskettes are identical after the copy 
has completed. 


@ On PC-DOS, insert a blank diskette in drive A. Enter: 
FORMAT A: <CR> 
Then enter: 


DISKCOPY A: A: <CR> 





When MS/PC-DOS first prompts for the destination diskette, remove the source 
diskette and insert a blank diskette. Follow the prompts, removing and inserting 
the source and destination diskettes as directed. When MS/PC-DOS prompts: 


COPY ANOTHER (Y/N)? 
respond with N. 
Copy the Macro Assembler onto the hard disk or the system disk. 


On hard-disk systems, enter: 


COPY A:XASM.EXE E:*.*/V <CR> 
On dual floppy-drive systems, enter: 
COPY A:XASM.EXE B:*.*/V <CR> 
Copy the Link Editor onto the hard disk or the system disk: 


On hard-disk systems, enter: 


COPY A:LINKER.EXE E:*.*/V <CR> 
On dual floppy-drive systems, enter: 


COPY A:LINKER.EXE B:*.*/V <CR> 
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G.2.3 Executing the Macro Assembler 


To execute the Macro Assembler, enter: — 
XASM <CR> | | 


The command line parser prompts for the source, listing, and object file names: 


Source File Enter the source file name (if the source file does not have an 
extension, then type the file name with an explicit ’.’). 

Listing File Enter the output listing file name. 

Object File Enter the output object file name. 


MS/PC-DOS creates defaults for the listing and object files and/or their extensions. 
The default extensions are: 


ASM Source file 
LST Listing file 
MPO Object file 


In the following examples, two special command characters are used: semicolon (;) 
and comma (,). Using a semicolon (;) followed immediately by a carriage return at 
any time after the first filename in a command line selects the default responses to 
the remaining prompts. The comma (,) separates responses to successive prompts. 


Examples: 


XASM <filename>.SRC; 

- Uses <filename> with extension SRC. 

- Generates defaults for the listing file <filename.LST> and object file 
<filename>.MPO. . | 


XASM <filename>; 
- Uses <filename> with default extension ASM. 
- Generates defaults for the listing and object files as indicated above. 


XASM <filename>,<newname>; 
7 Uses <filename> with default extension ASM. 
- Generates listing file <newname>.LST and object file <newname>.MPO. 


XASM <filename>,<newname> 
= Uses <filename> with default extension ASM. 
~ Generates listing file <newname>.LST and prompts for object file name. 


G.2.4 Executing the Link Editor 
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To execute the Linker, enter: 
LINKER <CR> 


The command line parser prompts for the control, linkmap, and load file names. 


Control File Enter the control file name with extension (if the control file does 
not have an extension, type the file name with an explicit ’.’). 
Map File Enter the linkmap file name with extension. 


Load File Enter the load module file name with extension. 


MS/PC-DOS generates defaults for the linkmap and load files and/or their exten- 
sions. The default extensions are: 


CTL Control file 
MAP Linkmap file 
.LOD Load file 
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In the following examples, two special command characters are used: semicolon (;) 
and comma (,). Using a semicolon (;) followed immediately by a carriage return at 
any time after the first filename in a command line selects the default responses to 
the remaining prompts. The comma (,) separates responses to successive prompts. 


Examples: 


LINKER <filename>.SRC; 
= Uses <filename> with extension SRC. 
- Generates defaults for the linkmap and load files as indicated above. 


LINKER <filename>; 
- Uses <filename> with default extension CTL. 
~ Generates defaults for the linkmap and load files as indicated above. 


LINKER <filename>,<newname>; 
= Uses <filename> with default extension CTL. 
- Generates linkmap file <newname>.MAP and load file <newname>.LOD. 


LINKER <filename> , <newname> 
7 Uses <filename> with default extension CTL. 
- Generates linkmap file <newname>.MAP and prompts for the load file name. 


G.2.5 Testing the Macro Assembler 


® Hard-Disk Systems 


1) Copy the FFT.ASM test file from the backup diskette onto the hard disk 
using the MS/PC-DOS COPY utility: 


COPY A:FFT.ASM Es *2*7V <CR> 


2) Execute the Macro Assembler using FFT.ASM as the source file. By 
entering: 


XASM FFT; <CR> 


in response to the system prompt, the Assembler generates the default 
object file.FFT.MPO and default listing file FFT.LST. 


3) Compare the listing and object files just created to those on the backup 
diskette: 


- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM FFT.MPO A:FFT.MPO <CR> 
FILCOM FFT.LST A:FFI.LST <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE FFT.MPO <CR> 
TYPE A:FFT.MPO <CR> 








TYPE FFT.LST <CR> 
TYPE A:FFT.LST <CR> 











Only lines containing dates or times should differ. 
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1) 
2) 


3) 


Note: 


Floppy- Drive Systems: 


Insert the backup diskette into the default floppy drive. 


Execute the Macro Assembler using FFT.ASM as the source test file. It 
is important to use a different name for the object and listing files. Other- 
wise, the Assembler will write over these files on the backup diskette, and 
there will be no correct mee with which to compare the created files. By 
entering: 


XASM FFT, ,MYFFT; <CR> 





in response to the system prompt, the Assembler generates object file 
MYFFT.MPO and listing file MYFFT.LST. 


Compare the listing and object files just created to those shipped on the 
backup diskette: 


~ On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM FFT.MPO MYFFT.MPO <CR> 
FILCOM FFT.LST MYFFT.LST <CR> 








The contents of each file can be viewed with the TYPE utility. 


~ On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE FET.MPO <CR> 
TYPE MYFFT.MPO <CR> 





TYPE FET. bor <CR> 
TYPE MYFET UST <CR> 





Only lines containing dates or times should differ. 


The files TEST1.ASM and TEST2.ASM, contained in the Linker portion of the 
diskette, can also be used to test the Macro Assembler. 





G.2.6 Testing the Link Editor 


6 Hard-Disk Systems 


1) 


2) 


3) 


Copy the LNKTST.CTL, TST1.MPO, and TST2.MPO files from the backup 
diskette onto the hard disk using the MS/PC-DOS COPY utility: 


COPY A:LNKTST.CTL E:*.*/V <CR> 

COPY A:TST*.MPO E:*.*/V <CR> 

Execute the Link Editor using LNKTST.CTL as the control file. By entering: 
LINKER LNKTST; <CR> | 





in response to the system prompt, the Linker generates the default linkmap 
file LNKTST.MAP and default load file LNKTST.LOD. 


Compare the map and load files just created to those on the backup 
diskette: 
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- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM LNKTST.MAP A:LNKTST.MAP <CR> 
FILCOM LNKTST.LOD A:LNKTST.LOD <CR> 


The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 


files and to visually check the contents for verification: 


TYPE LNKTST.MAP <CR> 
TYPE A: LNKTST.MAP <CR> 








TYPE LNKTST.LOD <CR> 
TYPE A:LNKTST.LOD <CR> 











Only lines containing dates or times should differ. 


Floppy-Drive Systems: 


1) 
2) 


3) 


Insert the backup diskette into the default floppy drive. 


Execute the Link Editor using LNKTST.CTL as the control file. It is 
important to use a different name for the map and load files. Otherwise, 
the Linker will write over these files on the backup diskette, and there will 
be no correct files with which to compare the created files. By entering: 


LINKER LNKTST,MYLNK; <CR> 





in response to the system prompt, the Linker generates the linkmap file 
MYLNK.MAP and load file MYLNK.LOD. 


Compare the map and load files just created to those shipped on the 
backup diskette: 


- On MS-DOS, use the FILCOM utility to make the comparison: 


FILCOM LNKTST.MAP MYLNK.MAP <CR> 
FILCOM LNKTST.LOD MYLNK.LOD <CR> 





The contents of each file can be viewed with the TYPE utility. 


- On PC-DOS, use the TYPE utility to show the contents of the two 
files and to visually check the contents for verification: 


TYPE LNKTST.MAP <CR> 
TYPE MYLNK.MAP <CR> 


TYPE LNKTST.LOD <CR> 
TYPE MYLNK.LOD <CR> 








Only lines containing dates or times should differ. 
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Graham (513) 435-8660; Kierulff (513) 439-0045; 
Marshall (513) 236- 8088. 


OKLAHOMA: Arrow (918) 665-7700; 
Kierulff (918) 252-7537. 


OREGON: Arrow (503) 684-1690 
Kierulff (503) 641-9153; Wyle 563) 640-6000; 
Marshall (503) 644- 5050. 


PENNSYLVANIA: Arrow (412) 856-7000, 
(215) 928-1800; General Radio (215) 922-7037. 


RHODE ISLAND: Arrow (401) 431-0980 


TEXAS: Austin: Arrow (512) 835-4180; 

Hall-Mark (512) 258-8848; Kierulff (512) 835-2090; 
Marshall (512) 837- yey i Wyle (512) 834-9957; 
Dallas: Arrow (214) 380 

Hall-Mark (214) 553- 4300; *Kieruttt (214) 343-2400; 
Marshall (214) 233-5200; ‘Wyle (214) 235-9953; 
Zeus (214) 783-7010; 

Houston: Arrow (713) 530-4700; 

Hall-Mark (713) 781-6100; Kierulff (713) 530-7030; 
Marshall (713) 895-9200; ‘Wyle (713) 879-9953. 


UTAH: Arrow (801) 972-0404; 

Diplomat (801) 486-4134; 

Hall-Mark (801) 268- 3779; Kierulff (801) 973-6913; 
Wyle (801) 974-9953. 


WASHINGTON: Arrow (206) 643-4800; 
Kierulff (206) 575-4420; Wyle (206) 453- 8300; 
Marshall (206) 747- 9100. 


WISCONSIN: Arrow (414) 792-0150; 
Hall-Mark (414) 797-7844; Kierulff (414) 784-8160; 
Marshall (414) 797-8400. 


CANADA: Calgary: Future (403) 235-5325; 
Edmonton: Future (403) 438-2858; 
Montreal: Arrow Canada (514) 735: 5511; 
Future (514) 694-7710; 

Ottawa: Arrow Canada (613) 226-6903; 
Future (613) 820-8313; 

Quebec City: Arrow Ganada (418) 687-4231; 
Toronto: Arrow Canada (416) 661-0220; 
Future (416) 638-4771; 

Vancouver: Future (604) 294-1166 
Winnipeg: Future (204) 339-0554 





TI Worldwide 
Sales Offices 


ALABAMA: Huntsville: 500 Wynn Drive, Suite 514, 
Huntsville, AL 35805; (205) 837-7530. 


ARIZONA: Phoenix: 8825 N. 23rd Ave., Phoenix, 
AZ 85021, (602) 995-1007. 


CALIFORNIA: Irvine: 17891 Cartwright Rd., Irvine, 
CA 92714, (714) 660-8187; Sacramento: 1900 Point 
West Way, Suite 171, Sacramento, CA 95815, 
(916) 929-1521; San Diego: 4333 View Ridge Ave., 
Suite B., San Diego, CA 92123, (619) 278-9601; 
Santa Clara: 5353 Betsy Ross Dr., Santa Clara, CA 
95054, (408) 980-9000; Torrance: 690 Knox St., 
Torrance, CA 90502, (213) 217-7010; 

Woodland Hills: 21220 Erwin St., Woodland Hills, 
CA 91367, (818) 704-7759. 


COLORADO: Aurora: 1400 S. Potomac Ave., 
Suite 101, Aurora, CO 80012, (303) 368-8000. 


CONNECTICUT: Wallingford: 9 Barnes Industrial 
Park Rd., Barnes Industrial Park, Wallingford, 
CT 06492, (203) 269-0074. 


FLORIDA: Ft. Lauderdale: 2765 N.W. 62nd St., 
Ft. Lauderdale, FL 33309, (305) 973-8502; 
Maitland: 2601 Maitland Center Parkway, 
Maitland, FL 32751, (305) 660-4600; 

Tampa: 5010 W. Kennedy Bivd., Suite 101, 
Tampa, FL 33609, (813) 870-6420. 


GEORGIA: Norcross: 5515 Spalding Drive, Norcross, 
GA 30092, (404) 662-7900 : 


ILLINOIS: Arlington Heights: 515 W. Algonquin, 
Arlington Heights, IL 60005, (312) 640-2925. . 


INDIANA: Ft. Wayne: 2020 Inwood Dr., Ft. Wayne, 
IN 46815, (219) 424-5174; 

Indianapolis: 2346 S. Lynhurst, Suite J-400, 
Indianapolis, IN 46241, (317) 248-8555. 


1OWA: Cedar Rapids: 373 Collins Rd. NE, Suite 200, 
Cedar Rapids, !A 52402, (319) 395-9550. 


MARYLAND: Baltimore: 1 Rutherford Pl., 
7133 Rutherford Rd., Baltimore, MD 21207, 
(301) 944-8600. 


MASSACHUSETTS: Waltham: 504 Totten Pond Rd., 
Waltham, MA 02154, (617) 895-9100. 


_MICHIGAN: Farmington Hills: 33737 W. 12 Mile Rd., 
Farmington Hills, Ml 48018, (313) 553-1500. 


MINNESOTA: Eden Prairie: 11000 W. 78th St., 
Eden Prairie, MN 55344 (612) 828-9300. 


MISSOURI: Kansas City: 8080 Ward Pkwy., Kansas 
City, MO 64114, (816) 523-2500; 

St. Louis: 11816 Borman Drive, St. Louis, 

MO 63146, (314) 569-7600. 


NEW JERSEY: Iselin: 485E U.S. Route 1 South, 
Parkway Towers, Iselin, NJ 08830 (201) 750-1050 


NEW MEXICO: Albuquerque: 2820-D ‘Broadbent Pkwy 
NE, Albuquerque, NM 87107, (505) 345-2555. 


NEW YORK: East Syracuse: 6365 Collamer Dr., East 
Syracuse, NY 13057, (315) 463-9291; 

Endicott: 112 Nanticoke Ave., P.O. Box 618, Endicott, 
NY 13760, (607) 754-3900; Melville: 1 Huntington 
Quadrangle, Suite 3C10, P.O. Box 2936, Melville, 

NY 11747, (516) 454-6600; Pittsford: 2851 Clover St., 
Pittsford, NY 14534, (716) 385-6770; 

Poughkeepsie: 385 South Rd., Poughkeepsie, 

NY 12601, (914) 473-2900. 


NORTH CAROLINA: Charlotte: 8 Woodlawn Green, 
Woodlawn Rd., Charlotte, NC 28210, (704) 527-0930; 
Seen 2809 Highwoods Bivd., Suite 100, Raleigh, 
NC 27625, (919) 876-2725. 


OHIO: Beachwood: 23408 Commerce Park Rd., 
Beachwood, OH 44122, (216) 464-6100; 

Dayton: Dea, Bidg., 4124 Linden Ave., Dayton, 
OH 45432, (513) 258-3877. 


OREGON: Beaverton: 6700 SW 105th St., Suite 110, 
Beaverton, OR 97005, (503) 643-6758. 


PENNSYLVANIA: Ft. Washington: 260 New York Dr., 
Ft. Washington, PA 19034, (215) 643-6450; 
Coraopolis: 420 Rouser Rd., 3 Airport Office Park, 
Coraopolis, PA 15108, (412) 771-8550. 


PUERTO RICO: Hato Rey: Mercantil Plaza Bidg., 
Suite 505, Hato Rey, PR 00919, (809) 753-8700. 


TEXAS: Austin: P.O. Box 2909, Austin, TX 78769, 
(512) 250-7655; Richardson: 1001 E. Campbell Rd., 
Richardson, TX 75080, | 

(214) 680-5082; Houston: 9100 Southwest Frwy., 
Suite 237, Houston, TX 77036, (713) 778-6592; . 
San Antonio: 1000 Central Parkway South, 

San Antonio, TX 78232, (512) 496-1779. 


UTAH: Murray: 5201 South Green SE, Suite 200, 
Murray, UT 84107, (801) 266-8972. 


VIRGINIA: Fairfax: 2750 Prosperity, Fairfax, VA 
22031, (703) 849-1400. 


WASHINGTON: Redmond: 5010 148th NE, Bidg B, 
Suite 107, Redmond, WA 98052, (206) 881-3080. 


WISCONSIN: Brookfield: 450 N. Sunny Slope, 
Suite 150, Brookfield, WI 53005, (414) 785-7140. 


CANADA: Nepean: 301 Moodie Drive, Mallorn 
Center, Nepean, Ontario, Canada, K2H9C4, 

(613) 726-1970. Richmond Hill: 280 Centre St. E., 
Richmond Hill L4C1B1, Ontario, Canada 

(416) 884-9181; St. Laurent: Ville St. Laurent Quebec, 
9460 Trans Canada Hwy., St. Laurent, Quebec, 
Canada H4S1R7, (514) 335-8392. 





ARGENTINA: Texas Instruments Argentina 
S.A.1.C.F.: Esmeralda 130, 15th Floor, 1035 Buenos 
Aires, Argentina, 1+ 394-3008. 


AUSTRALIA (& NEW ZEALAND): Texas Instruments 
Australia.Ltd.: 6-10 Talavera Rd., North Ryde 
(Sydney), New South Wales, Australia 2113, 

2 + 887-1122: 5th Floor, 418 St. Kilda Road, 
Melbourne, Victoria, Australia 3004, 3 + 267-4677; 
171 Philip Highway, Elizabeth, South Australia 5112, 
8 + 255-2066. 


AUSTRIA: Texas Instruments Ges.m.b.H.: 
Industriestrabe B/16, A-2345 Brunn/Gebirge, 
2236-846210. 


BELGIUM: Texas Instruments N.V. Belgium S.A.: 


Mercure Centre, Raketstraat 100, Rue de la Fusee, 
1130 Brussels, Belgium, 2/720.80.00. 


BRAZIL: Texas Instruments Electronicos do Brasil 
Ltda.: Rua Paes Leme, 524-7 Andar Pinheiros, 05424 
Sao Paulo, Brazil, 0815-6166. 


DENMARK: Texas Instruments A/S, Mairelundvej 
46E, DK-2730 Herlev, Denmark, 2 - 91 74 00. 


FINLAND: Texas Instruments Finland OY: 
Feoleuenatu 19D 00511 Helsinki 51, Finland, (90) 


FRANCE: Texas Instruments France: Headquarters 
and Prod. Plant, BP 05, 06270 Villeneuve-Loubet, 
(93) 20-01-01; Paris Office, BP 67 8-10 Avenue 
Morane-Saulnier, 78141 Velizy-Villacoublay, 

(3) 946-97-12; Lyon Sales Office, L’Oree D’Ecully, 
Batiment B, Chemin de la Forestiere, 69130 Ecully, 
(7) 833-04-40; Strasbourg Sales Office, Le Sebastopol 
3, Quai Kleber, 67055 Strasbourg Cedex, 

(88) 22-12-66; Rennes, 23-25 Rue du Puits Mauger, 
35100 Rennes, (99) 31-54-86; Toulouse Sales Office, 
Le Peripole—2, Chemin du Pigeonnier de la Cepiere, 
31100 Toulouse, (61) 44-18-19; Marseille Sales Office, 
Noilly Paradis—146 Rue Paradis, 13006 Marseille, 
(91) 37-25-30. 


I 





TEXAS 
INSTRUMENTS 


Creating useful products 
and services for you 


GERMANY (Fed. Republic of Germany): Texas 
instruments Deutschland GmbH: Haggertystrasse 1, 
D-8050 Freising, 8161 + 80-4591; Kurfuerstendamm 
195/196, D-1000 Berlin 15, 30+ 882-7365; Ill, Hagen 
43/Kibbelstrasse, .19, D-4300 Essen, 201-24250; 
Frankfurter Allee 6-8, D-6236 Eschborm 1, 
06196 + 8070; Hamburgerstrasse 11, D-2000 Hamburg 
76, 040 + 220-1154, Kirchhorsterstrasse 2, D-3000 | 
Hannover 51, 511 +648021; Maybachstrabe 11, 
D-7302 Ostfildern 2-Nelingen, 711 +547001; 
Mixikoring 19, D-2000 Hamburg 60, 40 + 637 + 0061; 
Postfach 1309, Roonstrasse 16, D-5400 Koblenz, 

261 + 35044. 


HONG KONG (+ PEOPLES REPUBLIC OF CHINA): - 
Texas Instruments Asia Ltd., 8th Floor, World 
Shipping Ctr., Harbour City, 7 Canton Rd., Kowloon, 
Hong Kong, 3 + 722-1223. 


IRELAND: Texas Instruments (Ireland) Limited: 
eae Rd., Stillorgan, County Dublin, Eire, 


ITALY: Texas Instruments Semiconduttori Italia Spa: 
Viale Delle Scienze, 1, 02015 Cittaducale (Rieti), 
Italy, 746 694.1; Via Salaria KM 24 (Palazzo Cosma), 
Monterotondo Scalo (Rome), Italy, 6 + 9003241; Viale 
Europa, 38-44, 20093 Cologno Monzese (Milano), 

2 2532541; Corso Svizzera, 185, 10100 Torino, Italy, 
: eee Via J. Barozzi 6, 40100 Bologna, Italy, 51 


JAPAN: Texas Instruments Asia Ltd.: 4F Aoyama 
Fuji Bldg., 6-12, Kita Aoyama 3-Chome, Minato-ku, 


| Tokyo, Japan 107, 3-498-2111; Osaka Branch, 5F, 


Nissho Iwai Blidg., 30 Imabashi 3- Chome, 
Higashi-ku, Osaka, Japan 541, 06-204-1881; Nagoya 
Branch, 7F Daini Toyota West Bldg., 10-27, Meieki 
4-Chome, Nakamura-ku Nagoya, Japan 

450, 52-583-8691. 


KOREA: Texas Instruments Supply Co.: 3rd Floor, 
Samon Bldg., Yuksam-Dong, Gangnam-ku, 
135 Seoul, Korea, 2 + 462-8001. 


NEXICO: Texas Instruments de Mexico S.A.: Mexico 
City, AV Reforma No. 450 — 10th Floor, Mexico, 
D.F., 06600, 5+ 514-3003. 


MIDDLE EAST: Texas Instruments: No. 13, 1st Floor 
Mannai Bidg., Diplomatic Area, P.O. Box 26335, 


._Manama Bahrain, Arabian Gulf, 973+ 274681. 


NETHERLANDS: Texas Instruments Holland B.V., 
P.O. Box 12995, (Bullewijk) 1100 CB Amsterdam, 
Zuid-Oost, Holland 20 + 5602911. 


NORWAY: Texas Instruments Norway A/S: PB106, 
Refstad 131, Oslo 1, Norway, (2) 155090. 


PHILIPPINES: Texas Instruments Asia Ltd.: 14th 
Floor, Ba- Lepanto Ag 8747 Paseo de Roxas, 
Makati, Metro Manila, Philippines, 2 + 8188987. 


PORTUGAL: Texas Instruments Equipamento 
Electronico (Portugal), Lda.: Rua Eng. Frederico 
Ulrich, 2650 Moreira Da Maia, 4470 Maia, Portugal, 
2-948-1003. 


SINGAPORE (+ INDIA, INDONESIA, MALAYSIA, 
THAILAND): Texas Instruments Asia Ltd.: 12 Lorong 
Bakar Batu, Unit 01-02, Kolam Ayer Industrial Estate, 


_ Republic of Singapore, 747-2255. 


SPAIN: Texas Instruments Espana, S.A.: C/Jose 
Lazaro Galdiano No. 6, Madrid 16, 1/458.14.58. 


SWEDEN: Texas Instruments International Trade 
Corporation (Sverigefilialen): Box 39103, 10054 
Stockholm, Sweden, 8 - 235480. 


SWITZERLAND: Texas Instruments, Inc., Reidstrasse 
6, CH-8953 Dietikon (Zuerich) Switzerland, 
1-740 2220. 


TAIWAN: Texas Instruments Supply Co.: Room 903, 
205 Tun Hwan Rd., 71 Sung-Kiang Road, Taipei, 
Taiwan, Republic of China, 2 + 521-9321. 


UNITED KINGDOM: Texas Instruments Limited: : 
Manton Lane, Bedford, MK41 7PA, England, 0234 
67466; St. James House, Wellington Road North, 
Stockport, SK4 2RT, England, 61 + 442-7162. 
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TMS320C25 User’s Guide 


Please use this form to communicate your comments about this document, its 
Organization and subject matter, for the purpose of improving technical documen- 
tation. 


1) 


2) 


3) 


4) 


9) 


6) 


1) 


What do you feel are the best features of this document? 


How does this document meet your digital signal processing needs? 


Do you find the organization of this document easy to follow? If not, why? 


What additions do you think would enhance the structure and subject matter? 


What deletions could be made without affecting overall usefulness? 
Is there any incorrect or misleading information? 


How would you improve this document? 


If you would like a reply, please give your name and address below. 


Name 

Company | Title 
Address 

City/State/Zip Telephone 


Thank you for your cooperation. 
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Instruction Set Summary (Concluded) 


Mnemonic Description # Words Instruction Bit Code 


eae Y FEDCBA9876543210 


Set serial port transmit 1100111000100001 

mode 

Subtract from accumulator 

with shift 

Subtract from accumulator 

with borrow 

Conditional subtract 

Subtract from high 

accumulator 

Subtract from accumulator 

short immediate 

Subtract from low 

accumulator with sign- 

extension suppressed 

Subtract from accumulator 

with shift specified by 

T register 

Set external flag 11 

Table read 01 

Table write 01 
11 
01 


0001+S —+l-—— D——> 
01607111 -——)——= 


OCT i h—Dp—= 
01000100 l-——D-—— 


120019 O=———_———— 
61.0601 O81 p= 


01000110 }——D 


Software interrupt 
Exclusive-OR with 
accumulator 

Exclusive-OR immediate 
with accumulator with 
shift 

Zero accumulator 

Zero low accumulator and 
load high accumulator 
Zero low accumulator and 
load high accumulator with 
rounding 

Zero accumulator and load 
low accumulator with 
sign-extension suppressed 


Assembler Directives (Concluded) 


LOAD (Force Load): Defines symbols for other programs. 
[<label>] LOAD <symbol>[,<symbol>] [<comment>] 


MLIB (Define MACRO Library): Specifies the library containing 
macro definitions. 
[<label>] MLIB ‘'<pathname>’ [<comment>] 


01 
11 
11 
01 
01 


0 
0 
0 
0 
0 
10 


1+S—>00000110 


1100101000000000 
01000000 I-——_D 


SPE OF —— >——— 


0+000007 h-——)D—< 


OPTION (Output Options): Selects several options for the 
assembler listing output. 
[<label>] OPTION <option list> [<comment>] 


PAGE (Eject Page): Continues source listing on new page. 
[<label>] PAGE [<comment>] 


PEND (Program Segment End): Terminates definition of a block 
of program-relocatable code. 
[<label>] PEND [<comment>] 


PSEG (Program Segment): Defines succeeding locations as 
program-relocatable. 
[<label>] PSEG [<comment>] 


REF (External Reference): Provides access to symbols defined 
in other programs. 
[<label>] REF <symbol>[,<symbol>] [<comment>] 


RORG (Relocatable Origin): Defines succeeding locations as 
program-relocatable and initializes location counter. 
[<label>] RORG [[<exp>] /<comment>/] 


SREF (Secondary External Reference): Provides secondary 
access to symbols defined in other programs. 
[<label>] SREF <symbol>[,<symbol>] [<comment>] 


TEXT (initialize Text): Places a character string in successive 
program memory words. 
[<label>] TEXT [-]’<string>’ [<comment>] 


TITL (Page Title): Supplies source listing page titles. 
[<label>] TITL ‘<string>’ [<comment>] 


UNL (Stop Source Listing): Halts source listing output until the 
occurrence of a LIST directive. 
[<label>] UNL [<comment>] 


XEND (independent Segment End): Terminates definition of 
an independently stored program segment, definedby EXEC. 
[<label>] XEND [<comment>] 





TMS320C25 
DIGITAL SIGNAL PROCESSOR 
Programmer’s Reference Card 


Ti Customer Response Center (CRC) Hotline Number 
For help with the TMS320C25, call 1-800-232-3200. 


Symbols for Instruction Set Summary 


symBot| MEANING 


4-bit field specifying a bit code 
2-bit field specifying compare mode 
Data memory address field 

Format status bit 

Addressing mode bit 


‘Immediate operand field 

Port address (PAO through PA15 are predefined assem- 
bler symbols equal to 0 through 15, respectively.) 

2-bit field specifying P register output shift code 

3-bit operand field specifying auxiliary register 

4-bit left-shift code 

3-bit accumulator left-shift field 





Assembler Directives 


AORG (Absolute Origin): Defines succeeding locations as 
absolute and places a value in the location counter. 
[<label>] AORG [<exp> /<comment>/] 


BES (Block Ending with Symbol): Advances location counter 
and assigns a label the value of location following block. 
[<label>] BES <exp> [<comment>] 


BSS (Block Starting with Symbol): Advances location counter 
and assigns a label the value of location of first word in block. 
[<label>] BSS <exp> [<comment>] 


CEND (Common Segment End): Terminates definition of a 
POs, of common-relocatable code. 
[<label>] CEND [<comment>] 


COPY (Copy Source File): Causes source statements to be read 
from a different file. 
[<label>] COPY <file-name> [<comment>] 


CSEG (Common Segment): Defines succeeding locations as 
common-relocatable. 
[<label>] CSEG ['<string>’ /<comment>/] 


DATA (Initialize Word): Places values in successive program 
memory words. 
[<label>] DATA <exp>[,<exp>] [<comment>] 


DEF (External Definition): Defines symbols for other programs. 
[<label>] DEF <symbol>[,<symbol>] [<comment>] 


DEND (Data Segment End): Terminates definition of a block 
of data-relocatable code. 
[<label>] DEND [<comment>] 


DORG (Dummy Origin): Defines succeeding locations as a 
dummy block. 
[<label>] DORG <exp> [<comment>] 


DSEG (Data Segment): Defines succeeding locations as data- 
relocatable. 
[<label>] DSEG [<comment>] 


END (Program End): Terminates the assembly. 
[<label>] END [<symboi>/<comment/] 


EQU (Define Assembly- Time Constant): Assigns symbol value. 
[<label>] EQU <exp> [<comment>] 


EXEC (Independent Program Segment): Defines independently 
stored program segment and loads location counter. 
[<label>] EXEC <pma> [<comment>] 


IDT (Program Identifier): Names the object module produced. 
[<label>] IDT ‘<string>’ [<comment>] 


LIST (Restart Source Listing): Resumes source listing. 
[<label>] LIST [<comment>] 


Si TEXAS 
INSTRUMENTS 
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Instruction Set Summary (Continued) 


Mnemonic Description # Words ___siInstruction Bit Code 


meen FEDCBA987654321 0 


Instruction Set Summary 


Mnemonic Description # Words __ Instruction Bit Code 


po) ED CE ROUT 0543210 


Absolute value of accumu- 
lator 

Add to accumulator with 
shift 

Add to accumulator with 
carry 

Add to high accumulator 
Add to accumulator 

short immediate 

Aad to low accumulator 
with sign-extension 
suppressed 

Add to accumulator with 
shift specified by T register 
Add to accumulator long 
immediate with shift 

Add to auxiliary register 
short immediate 

AND with accumulator 
AND immediate with accu- 


110011100001101 1 
0000-S—+k— D 
01000011 -—D 
01001000k—D 


14001 1900e-—t———e 


01001001 k—D 


01001010k—D 
1101+S—+0000001 0 
01111110e——K 


01001110k——D 
1101+S—~+00000100 


Load T register and accu- 
mulate previous product 
Load T register, accumulate 
previous product, and 
move data 

Load T register and store 

P register in accumulator 
Load T register and subtract 
previous product 

Multiply and accumulate 
Multiply and accumulate 
with data move 

Modify auxiliary register 
Multiply (with T register, 
store product in P register) 
Multiply and accumulate 
previous product 

Multiply immediate 
Multiply and subtract 
previous product 


00111101 I+—D 
HOt t511) a Db 


00111110 1-— 0——=+ 
071011011 Ww D—— 


01011101 k+— D-——= 
01011100 I-— D—+ 


07010101 —— D—-= 
00111000 k— D—~ 


00111010 Il D—~— 


10 i———— 


G913 1011 o—D)p—— 


mulator with shift Multiply unsigned 11001111 le—D—~> 
Add P register to accumu- 1100111000010101 Negate accumulator 110011100010001 1 
lator Fr No operation 0101010100000000 
Branch unconditionally — 1 NORM Normalize contents of accu- 110011101——D—+ 
Branch to address specified 1000100101 umulator 

by accumulator OR OR with accumulator 010011011+—D 
Branch on auxiliary register ORK OR immediate with accu- 1101+S—+00000101 


not zero 

Branch if TC bit # O 
Branch if TC bit = 0 
Branch on carry 

Branch if accumulator > 0 
Branch if accumulator > O 
Test bit 

Test bit specified by T 
register 

Branch on I/O status = 0 
Branch if accumulator < 0 
Block move from data mem- 


— = PON NN PAP 


OUT 


mulator with shift 
Output data to port 
Load accumulator with 
P register 

Pop top of stack to low 
accumulator 

Pop top of stack to data 
memory 

Push data memory value 
onto stack 

Push low accumulator 
onto stack 


1110<-PA+i+— D 
1100111000010100 


1100111000011101 
01111016 h—-.B 
01010100 I+—D 
1100111000011100 


ory to data memory Reset carry bit 1100111000110000 
Block move from program Return from subroutine 1100111000100110 
memory to data memory Reset serial port frame 1100111000110110 
Branch if accumulator < 0 synchronization mode 

Branch on no carry Reset hold mode 1100111000111000 
Branch if no overflow Rotate accumulator left 1100111000110100 
Branch if accumulator # 0 Rotate accumulator right 1100111000110101 
Branch on overflow Reset overflow mode 110011100000001 0 
Branch if accumulator = 0 Repeat instruction as speci- 01001011 I-—D 


Call subroutine indirect 
Call subroutine 
Complement accumulator 
Compare auxiliary register 
with auxiliary register ARO 
Configure block as data 
memory 

Configure block as program 
memory 


Disable interrupt 1 with shift 

Data move in data memory | 1 101——D——> Store low accumulator 01100+X—~-Ii~— D——> 
Enable interrupt 1 1000000000 with shift 

Format serial port registers | 1 100000111FO Store auxiliary register 01110+-R-I-+— D 

idle until interrupt 1 1000011111 Subtract from accumulator 1101+S—~+0000001 1 
Input data from port 1 long immediate with shift 

Load accumulator with 1 Subtract from auxiliary 0141111 ——kK 

Load accumulator imme- 1 register short immediate 

diate short Set carry bit 1100111000110001 
Load accumulator with 01000010 I-— D— Shift accumulator left 1100111000011000 
shift specified by T register Shift accumulator right 1100111000011001 
Load accumulator long 1101+S—~+00000001 Set serial port frame 110011100011011 1 
immediate with shift synchronization mode 

Load auxiliary register 00110+-R--Il-— D—— Set hold mode 1100111000111001 
Load auxiliary register 11000—R-+l-— K Set overflow mode 110011100000001 1 
immediate short Subtract P register from 1100111000010110 
Load auxiliary register 010101011000 1—R— accumulator 

pointer Store high P register 01111101I-—D 
Load data memory page 01010010 I*+—D Store low P register 01111100I+—D 
pointer Set P register output 11001110000010 P 
Load data memory page 1100100+—K shift mode 

pointer immediate Square and accumulate 00111001 I+— D 
Load high P register 01010011 I-—D Square and subtract 01011010I1*—D 
Load status register STO 01010000 I+— D previous product 

Load status register ST1 01010001 I+— D Store status register STO 01111000 I-— D—~ 
Load auxiliary register 11010+R+O00000000 Store status register ST1 01111001 I-—D 

long immediate Set sign-extension mode 110011100000011 1 
Load T register 00111100 Il-— D—~ Set test/control flag 110011100011001 1 


= -—M—NMNMNM MND PY Nh NON NO 
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00010011 1 
0010100 C 


1100111000000100 
1100111000000101 





fied by data memory value 
Repeat instruction as speci- 
fied by immediate value 
Reset sign-extension mode 
Reset test/control flag 
Reset serial port transmit 
mode 

Reset external flag 

Store high accumulator 





11600701 19K 


1100111000000110 
1100111000110010 
1100111000100000 


1100111000001100 
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